Zum Inhalt springen

MCP-Werkzeugreferenz

Dies sind die Werkzeuge, die linkcad-mcp einem Agenten anbietet. Der Agent liest ihre Beschreibungen und Argumentschemas vom Server; Sie müssen nichts davon weitergeben. Diese Seite dient dazu, zu prüfen, was ein Agent tun kann, und seine Werkzeugaufrufe zu lesen.

Eine Zeichnung wird durch das Handle bezeichnet, das open_drawing zurückgibt, etwa d1a2b3c-1. Pfade müssen unter den Ordnern liegen, die mit --root oder --read-root angegeben wurden (KI-Agenten verbinden). Koordinaten sind ganze Zahlen in Datenbankeinheiten; summary.units_per_meter in inspect_drawing rechnet sie um.

Informationen

WerkzeugArgumenteErgebnis
get_statusKeineLinkCAD-Version, Lizenzzustand und vorhandene Lizenzen (Basic, Tools, Edit, View), die Ordner und die geöffneten Zeichnungen.
list_formatsdirection: import oder export (optional)Jedes installierte Format mit seinem genauen Namen, Dateifilter und ob die Lizenz es abdeckt. Andere Werkzeuge verwenden diese Namen.
list_optionsfilter: Teil eines Optionsnamens, etwa GdsIn oder DxfOut; offset, limitKonvertierungsoptionen mit Typ, Standard- und aktuellem Wert und ob ein Werkzeugaufruf sie setzen darf.

Zeichnungen

WerkzeugArgumenteErgebnis
open_drawingpaths (eine oder mehrere Dateien), format, export_format, options, layer_mapEin Handle der Zeichnung, ihre Zusammenfassung und das Importprotokoll. Ohne format wird das Format aus der Datei erkannt.
inspect_drawingdrawing, view, cell, layer, offset, limitview ist summary (Einheiten, Ausdehnung, Anzahlen), layers, cells, hierarchy (die Zellen, die eine Zelle referenziert), shape_counts (je Zelle, Ebene und Formtyp) oder shapes (die Formen einer Zelle, seitenweise).
close_drawingdrawingGibt die Zeichnung frei. Höchstens acht Zeichnungen sind gleichzeitig geöffnet.

Geben Sie open_drawing das export_format mit, wenn die Zeichnung exportiert werden soll. LinkCAD vergibt Export-Ebenennummern und Zellnamen beim Lesen einer Datei, wie der Konvertierungsassistent, daher lässt sich das Exportformat später nicht ändern. Eine ohne Exportformat geöffnete Zeichnung kann untersucht, geändert und in der Vorschau angezeigt werden, aber export_drawing lehnt sie mit no_export_format ab.

options setzt Formatoptionen nach Namen, nur für diesen Aufruf, zum Beispiel {"GdsInIgnoreText": true}. layer_map wendet beim Lesen eine Ebenenzuordnungsdatei an und benötigt export_format.

Eine Zeichnung ändern

WerkzeugArgumenteErgebnis
apply_toolsdrawing, commandsFührt Werkzeugbefehle der Reihe nach aus und gibt die neue Zusammenfassung und das Protokoll zurück.
set_layersdrawing, layers, deleteÄndert Ebenen. Jeder Eintrag von layers nennt eine Ebene und setzt enabled (eine deaktivierte Ebene wird nicht exportiert), color (#RRGGBB, die Vorschaufarbe) oder rename_to. delete nennt Ebenen, die samt ihren Formen gelöscht werden.
list_plugin_toolsKeineDie installierten Python-Werkzeug-Plugins, jeweils mit ihren Optionen.
run_plugin_tooltool (als module:Class), drawing, optionsFührt ein Plugin-Werkzeug aus und gibt seinen Ergebnistext zurück. Optionen tragen ihre Kurznamen, etwa calculate_area.

commands sind die Befehle von --apply-tool, einer pro Array-Element, zum Beispiel ["SetUnits(um)", "MergeOverlappingPolygons()", "Offset(0.5)"]. Längen ohne Einheit sind Mikrometer. Modusbefehle wie SetUnits, SetFillRule und SetLayerFilter gelten für die nachfolgenden Befehle. Alle Befehle werden gegen die Lizenz geprüft, bevor der erste ausgeführt wird. Schlägt ein Befehl fehl, bleiben die vorherigen angewendet, und der Fehler nennt den fehlgeschlagenen Befehl.

set_layers prüft jeden Ebenennamen, bevor es etwas ändert. Ein falsch geschriebener Name ändert nichts und legt nie eine Ebene an.

Vorschau

WerkzeugArgumenteErgebnis
render_previewdrawing, width (64 bis 2048, Standard 1024), height (64 bis 2048, Standard 768), window, layers, fill (Standard true), background (black oder white)Ein PNG der Hauptzelle, gezeichnet wie im LinkCAD-Viewer, und der Maßstab in Datenbankeinheiten pro Pixel. window ist [xmin, ymin, xmax, ymax] in Datenbankeinheiten; layers beschränkt das Bild auf diese Ebenen.

Dateien schreiben

WerkzeugArgumenteErgebnis
export_drawingdrawing, path, overwriteSchreibt die Zeichnung im beim Öffnen gewählten Exportformat und gibt die geschriebenen Dateien und das Exportprotokoll zurück.
convert_fileinput (eine oder mehrere Dateien), output, output_format, input_format, options, layer_map, commands, overwriteLiest, führt Werkzeugbefehle aus und schreibt in einem Aufruf, ohne eine Zeichnung geöffnet zu lassen.
get_logdrawing, which (import oder export), offset, limitDas vollständige Import- oder Exportprotokoll, seitenweise. Werkzeugergebnisse enthalten die ersten Einträge des Protokolls.

Ein Export ersetzt nie die Datei, aus der die Zeichnung gelesen wurde. Eine andere vorhandene Datei ersetzt er nur mit overwrite: true. Der Writer schreibt zuerst in einen versteckten Ordner neben dem Ziel, und nur ein erfolgreicher Export wird an seinen Platz verschoben, alle seine Dateien gemeinsam. Einem Writer, der mehrere Dateien erzeugt, etwa eine Datei pro Ebene, kann ein Ordner als path übergeben werden.

Python

WerkzeugArgumenteErgebnis
execute_pythoncode, drawingFührt Python-Code im eingebetteten Interpreter von LinkCAD mit dem linkcad-Paket aus. Mit drawing ist diese Zeichnung die globale Variable drawing. Gibt Standardausgabe, Standardfehlerausgabe und gegebenenfalls den Fehler zurück.

execute_python gibt es nur, wenn der Server mit --allow-python gestartet wurde. Der Code läuft mit den Rechten Ihres Benutzers und ist nicht auf die Ordner beschränkt.

Ressourcen und Prompts

Der Server bietet außerdem Dokumente und Prompt-Vorlagen an. Clients zeigen Ressourcen als anfügbaren Kontext und Prompts als Befehle, in Claude Code zum Beispiel /mcp__linkcad__inspect_layout.

NameArtInhalt
linkcad://guide/agentRessourceWie die Werkzeuge zu verwenden sind: Ablauf, Einheiten, Optionsnamen, wie eine Konvertierung geprüft wird und was jeder Fehler bedeutet.
linkcad://reference/tool-applyRessourceDie Grammatik der Werkzeugbefehle.
linkcad://reference/python-apiRessourceDas Python-Paket linkcad. Nur mit --allow-python.
inspect_layoutPromptEine Datei öffnen und ihre Einheiten, Ausdehnung, Top-Zellen, Ebenen und ihr Protokoll melden, mit einer Vorschau.
convert_and_verifyPromptEine Datei konvertieren, die Ausgabe erneut öffnen und mit der Quelle vergleichen.

Fehler

Ein fehlgeschlagener Aufruf gibt einen Fehler mit einem festen Code, einer Meldung und bei Lese- und Schreibvorgängen dem Konvertierungsprotokoll zurück. Der Agent erhält dieselbe Tabelle in seinem Leitfaden.

CodeBedeutung
invalid_argumentsDie Argumente passen nicht zum Schema des Werkzeugs.
path_outside_roots, no_roots_configuredDer Pfad liegt nicht unter einem Ordner, den der Server erhalten hat.
path_not_writableDer Ordner ist schreibgeschützt (--read-root).
path_not_foundDie Datei existiert nicht.
file_existsDie Ausgabe existiert, und overwrite wurde nicht angegeben.
would_overwrite_inputDie Ausgabe ist die Quelldatei der Zeichnung selbst.
unknown_format, format_unavailableKein installierter Reader oder Writer trägt diesen Namen.
format_not_licensedDie Lizenz deckt das Format nicht ab.
license_blocked, license_read_only, license_unavailableDie Lizenz erlaubt dies nicht. get_status zeigt den Zustand und den Grund.
basic_license_required, tools_license_required, edit_license_required, view_license_requiredDie genannte Lizenz fehlt. Es wurde nichts geändert.
no_export_formatDie Zeichnung wurde ohne export_format geöffnet.
read_failed, write_failedDer Reader oder Writer ist fehlgeschlagen; das Protokoll nennt den Grund.
tool_failedEin Werkzeugbefehl ist fehlgeschlagen. Die Befehle davor wurden angewendet.
option_rejectedDie Option existiert nicht oder darf über den Server nicht gesetzt werden, etwa weil sie eine Anwendungseinstellung ist oder eigene Dateien schreibt.
unknown_drawing, unknown_layer, unknown_cellKeine Zeichnung, Ebene oder Zelle dieses Namens. Namen unterscheiden Groß- und Kleinschreibung.
too_many_drawingsAcht Zeichnungen sind geöffnet. Schließen Sie zuerst eine.
python_unavailable, unknown_plugin_tool, plugin_tool_failedPython konnte nicht starten, das Plugin-Werkzeug existiert nicht, oder es ist fehlgeschlagen.
python_errorDer an execute_python übergebene Python-Code konnte nicht ausgeführt werden.
render_failedDie Vorschau konnte nicht gezeichnet werden.
timeout, worker_crashedLinkCAD wurde neu gestartet und alle geöffneten Zeichnungen wurden geschlossen.
worker_start_failed, worker_protocol_error, internal_errorLinkCAD konnte nicht gestartet werden oder hat fehlerhaft geantwortet. Das Protokoll des Servers, das der Client anzeigt, nennt den Grund.
busyZu viele Aufrufe warten.