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
| Werkzeug | Argumente | Ergebnis |
|---|---|---|
get_status | Keine | LinkCAD-Version, Lizenzzustand und vorhandene Lizenzen (Basic, Tools, Edit, View), die Ordner und die geöffneten Zeichnungen. |
list_formats | direction: import oder export (optional) | Jedes installierte Format mit seinem genauen Namen, Dateifilter und ob die Lizenz es abdeckt. Andere Werkzeuge verwenden diese Namen. |
list_options | filter: Teil eines Optionsnamens, etwa GdsIn oder DxfOut; offset, limit | Konvertierungsoptionen mit Typ, Standard- und aktuellem Wert und ob ein Werkzeugaufruf sie setzen darf. |
Zeichnungen
| Werkzeug | Argumente | Ergebnis |
|---|---|---|
open_drawing | paths (eine oder mehrere Dateien), format, export_format, options, layer_map | Ein Handle der Zeichnung, ihre Zusammenfassung und das Importprotokoll. Ohne format wird das Format aus der Datei erkannt. |
inspect_drawing | drawing, view, cell, layer, offset, limit | view 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_drawing | drawing | Gibt 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
| Werkzeug | Argumente | Ergebnis |
|---|---|---|
apply_tools | drawing, commands | Führt Werkzeugbefehle der Reihe nach aus und gibt die neue Zusammenfassung und das Protokoll zurück. |
set_layers | drawing, 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_tools | Keine | Die installierten Python-Werkzeug-Plugins, jeweils mit ihren Optionen. |
run_plugin_tool | tool (als module:Class), drawing, options | Fü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
| Werkzeug | Argumente | Ergebnis |
|---|---|---|
render_preview | drawing, 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
| Werkzeug | Argumente | Ergebnis |
|---|---|---|
export_drawing | drawing, path, overwrite | Schreibt die Zeichnung im beim Öffnen gewählten Exportformat und gibt die geschriebenen Dateien und das Exportprotokoll zurück. |
convert_file | input (eine oder mehrere Dateien), output, output_format, input_format, options, layer_map, commands, overwrite | Liest, führt Werkzeugbefehle aus und schreibt in einem Aufruf, ohne eine Zeichnung geöffnet zu lassen. |
get_log | drawing, which (import oder export), offset, limit | Das 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
| Werkzeug | Argumente | Ergebnis |
|---|---|---|
execute_python | code, drawing | Fü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.
| Name | Art | Inhalt |
|---|---|---|
linkcad://guide/agent | Ressource | Wie die Werkzeuge zu verwenden sind: Ablauf, Einheiten, Optionsnamen, wie eine Konvertierung geprüft wird und was jeder Fehler bedeutet. |
linkcad://reference/tool-apply | Ressource | Die Grammatik der Werkzeugbefehle. |
linkcad://reference/python-api | Ressource | Das Python-Paket linkcad. Nur mit --allow-python. |
inspect_layout | Prompt | Eine Datei öffnen und ihre Einheiten, Ausdehnung, Top-Zellen, Ebenen und ihr Protokoll melden, mit einer Vorschau. |
convert_and_verify | Prompt | Eine 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.
| Code | Bedeutung |
|---|---|
invalid_arguments | Die Argumente passen nicht zum Schema des Werkzeugs. |
path_outside_roots, no_roots_configured | Der Pfad liegt nicht unter einem Ordner, den der Server erhalten hat. |
path_not_writable | Der Ordner ist schreibgeschützt (--read-root). |
path_not_found | Die Datei existiert nicht. |
file_exists | Die Ausgabe existiert, und overwrite wurde nicht angegeben. |
would_overwrite_input | Die Ausgabe ist die Quelldatei der Zeichnung selbst. |
unknown_format, format_unavailable | Kein installierter Reader oder Writer trägt diesen Namen. |
format_not_licensed | Die Lizenz deckt das Format nicht ab. |
license_blocked, license_read_only, license_unavailable | Die Lizenz erlaubt dies nicht. get_status zeigt den Zustand und den Grund. |
basic_license_required, tools_license_required, edit_license_required, view_license_required | Die genannte Lizenz fehlt. Es wurde nichts geändert. |
no_export_format | Die Zeichnung wurde ohne export_format geöffnet. |
read_failed, write_failed | Der Reader oder Writer ist fehlgeschlagen; das Protokoll nennt den Grund. |
tool_failed | Ein Werkzeugbefehl ist fehlgeschlagen. Die Befehle davor wurden angewendet. |
option_rejected | Die 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_cell | Keine Zeichnung, Ebene oder Zelle dieses Namens. Namen unterscheiden Groß- und Kleinschreibung. |
too_many_drawings | Acht Zeichnungen sind geöffnet. Schließen Sie zuerst eine. |
python_unavailable, unknown_plugin_tool, plugin_tool_failed | Python konnte nicht starten, das Plugin-Werkzeug existiert nicht, oder es ist fehlgeschlagen. |
python_error | Der an execute_python übergebene Python-Code konnte nicht ausgeführt werden. |
render_failed | Die Vorschau konnte nicht gezeichnet werden. |
timeout, worker_crashed | LinkCAD wurde neu gestartet und alle geöffneten Zeichnungen wurden geschlossen. |
worker_start_failed, worker_protocol_error, internal_error | LinkCAD konnte nicht gestartet werden oder hat fehlerhaft geantwortet. Das Protokoll des Servers, das der Client anzeigt, nennt den Grund. |
busy | Zu viele Aufrufe warten. |