MCP ツールリファレンス
linkcad-mcp がエージェントに提供するツールの一覧です。エージェントはツールの説明と引数のスキーマをサーバーから読み込むため、ユーザーがこれらを伝える必要はありません。このページは、エージェントにできることの確認や、エージェントのツール呼び出しを読むためのものです。
図面は、open_drawing が返すハンドル(d1a2b3c-1 など)で識別されます。パスは --root または --read-root で指定したフォルダーの下になければなりません(AI エージェントの接続)。座標はデータベース単位の整数です。inspect_drawing の summary.units_per_meter で換算できます。
情報
| ツール | 引数 | 結果 |
|---|---|---|
get_status | なし | LinkCAD のバージョン、ライセンスの状態と保有ライセンス(Basic、Tools、Edit、View)、フォルダー、開いている図面。 |
list_formats | direction: import または export(省略可) | インストールされているすべての形式と、その正確な名前、ファイルフィルター、ライセンスでカバーされるかどうか。他のツールはこれらの名前を使用します。 |
list_options | filter: GdsIn や DxfOut などのオプション名の一部、offset、limit | 変換オプションとその型、既定値、現在の値、ツール呼び出しで設定できるかどうか。 |
図面
| ツール | 引数 | 結果 |
|---|---|---|
open_drawing | paths(1 つ以上のファイル)、format、export_format、options、layer_map | 図面のハンドル、概要、インポートログ。format を省略すると、形式はファイルから検出されます。 |
inspect_drawing | drawing、view、cell、layer、offset、limit | view は summary(単位、範囲、数)、layers、cells、hierarchy(1 つのセルが参照するセル)、shape_counts(セル、レイヤー、形状タイプごと)、shapes(1 つのセルの形状、ページ単位)のいずれかです。 |
close_drawing | drawing | 図面を解放します。同時に開ける図面は最大 8 つです。 |
図面をエクスポートする場合は、open_drawing に export_format を指定してください。LinkCAD は変換ウィザードと同様に、ファイルの読み込み時にエクスポート用のレイヤー番号とセル名を割り当てるため、エクスポート形式を後から変更することはできません。エクスポート形式なしで開いた図面は、調査、変更、プレビューはできますが、export_drawing は no_export_format で拒否します。
options は形式のオプションを名前で指定し、その呼び出しにのみ適用します(例: {"GdsInIgnoreText": true})。layer_map は読み込み時にレイヤーマップファイルを適用し、export_format が必要です。
図面の変更
| ツール | 引数 | 結果 |
|---|---|---|
apply_tools | drawing、commands | ツールコマンドを順に実行し、新しい概要とログを返します。 |
set_layers | drawing、layers、delete | レイヤーを変更します。layers の各エントリはレイヤー名を指定し、enabled(無効なレイヤーはエクスポートされません)、color(#RRGGBB、プレビュー色)、rename_to を設定します。delete には、形状ごと削除するレイヤーを指定します。 |
list_plugin_tools | なし | インストールされている Python ツールプラグインとそれぞれのオプション。 |
run_plugin_tool | tool(module:Class の形式)、drawing、options | プラグインツールを実行し、その結果のテキストを返します。オプションは calculate_area などの短い名前で指定します。 |
commands は --apply-tool のコマンドで、配列の要素ごとに 1 つ指定します(例: ["SetUnits(um)", "MergeOverlappingPolygons()", "Offset(0.5)"])。単位のない長さはマイクロメートルです。SetUnits、SetFillRule、SetLayerFilter などのモードコマンドは、それ以降のコマンドに適用されます。最初のコマンドを実行する前に、すべてのコマンドのライセンスが確認されます。コマンドが失敗した場合、それ以前のコマンドは適用されたままとなり、エラーには失敗したコマンドが示されます。
set_layers は、何かを変更する前にすべてのレイヤー名を確認します。名前を間違えた場合は何も変更されず、レイヤーが作成されることもありません。
プレビュー
| ツール | 引数 | 結果 |
|---|---|---|
render_preview | drawing、width(64~2048、既定値 1024)、height(64~2048、既定値 768)、window、layers、fill(既定値 true)、background(black または white) | LinkCAD ビューアーと同じ方法で描画したメインセルの PNG と、ピクセルあたりのデータベース単位で表した縮尺。window はデータベース単位の [xmin, ymin, xmax, ymax] です。layers は描画をそれらのレイヤーに限定します。 |
ファイルの書き出し
| ツール | 引数 | 結果 |
|---|---|---|
export_drawing | drawing、path、overwrite | 図面を開いたときに選択したエクスポート形式で書き出し、書き出したファイルとエクスポートログを返します。 |
convert_file | input(1 つ以上のファイル)、output、output_format、input_format、options、layer_map、commands、overwrite | 読み込み、ツールコマンドの実行、書き出しを 1 回の呼び出しで行い、図面を開いたままにしません。 |
get_log | drawing、which(import または export)、offset、limit | インポートログまたはエクスポートログの全体(ページ単位)。ツールの結果にはログの先頭のエントリが含まれます。 |
エクスポートは、図面の読み込み元のファイルを置き換えません。その他の既存ファイルを置き換えるのは overwrite: true の場合だけです。ライターはまず出力先の隣の非表示フォルダーに書き込み、エクスポートが成功した場合にのみ、すべてのファイルをまとめて配置します。レイヤーごとに 1 ファイルなど複数のファイルを生成するライターには、path としてフォルダーを指定できます。
Python
| ツール | 引数 | 結果 |
|---|---|---|
execute_python | code、drawing | linkcad パッケージを使用して、LinkCAD の組み込みインタープリターで Python コードを実行します。drawing を指定すると、その図面がグローバル変数 drawing になります。標準出力、標準エラー出力、およびエラーがあればそのエラーを返します。 |
execute_python は、サーバーを --allow-python 付きで起動した場合にのみ存在します。コードはユーザーの権限で実行され、フォルダーの制限を受けません。
リソースとプロンプト
サーバーはドキュメントとプロンプトテンプレートも提供します。クライアントはリソースを添付可能なコンテキストとして、プロンプトをコマンドとして表示します。Claude Code では、たとえば /mcp__linkcad__inspect_layout です。
| 名前 | 種類 | 内容 |
|---|---|---|
linkcad://guide/agent | リソース | ツールの使い方: 作業の流れ、単位、オプション名、変換の検証方法、各エラーの意味。 |
linkcad://reference/tool-apply | リソース | ツールコマンドの文法。 |
linkcad://reference/python-api | リソース | Python パッケージ linkcad。--allow-python の場合のみ。 |
inspect_layout | プロンプト | ファイルを開き、単位、範囲、トップセル、レイヤー、ログをプレビュー付きで報告します。 |
convert_and_verify | プロンプト | ファイルを変換し、出力を開き直してソースと比較します。 |
エラー
失敗した呼び出しは、固定のコード、メッセージ、および読み込みと書き出しの場合は変換ログを含むエラーを返します。エージェントはガイドで同じ表を受け取ります。
| コード | 意味 |
|---|---|
invalid_arguments | 引数がツールのスキーマと一致しません。 |
path_outside_roots、no_roots_configured | パスがサーバーに指定されたフォルダーの下にありません。 |
path_not_writable | フォルダーが読み取り専用(--read-root)です。 |
path_not_found | ファイルが存在しません。 |
file_exists | 出力が存在し、overwrite が指定されていません。 |
would_overwrite_input | 出力が図面自身のソースファイルです。 |
unknown_format、format_unavailable | その名前のリーダーまたはライターがインストールされていません。 |
format_not_licensed | ライセンスがその形式をカバーしていません。 |
license_blocked、license_read_only、license_unavailable | ライセンスがこの操作を許可していません。get_status が状態と理由を示します。 |
basic_license_required、tools_license_required、edit_license_required、view_license_required | 指定されたライセンスがありません。何も変更されていません。 |
no_export_format | 図面が export_format なしで開かれました。 |
read_failed、write_failed | リーダーまたはライターが失敗しました。ログに理由が示されます。 |
tool_failed | ツールコマンドが失敗しました。それ以前のコマンドは適用されています。 |
option_rejected | オプションが存在しないか、アプリケーションの設定であったり独自にファイルを書き出したりするため、サーバー経由で設定できません。 |
unknown_drawing、unknown_layer、unknown_cell | その名前の図面、レイヤー、セルがありません。名前は大文字と小文字を区別します。 |
too_many_drawings | 8 つの図面が開いています。先に 1 つ閉じてください。 |
python_unavailable、unknown_plugin_tool、plugin_tool_failed | Python を起動できなかった、プラグインツールが存在しない、またはプラグインツールが失敗しました。 |
python_error | execute_python に渡した Python コードを実行できませんでした。 |
render_failed | プレビューを描画できませんでした。 |
timeout、worker_crashed | LinkCAD が再起動され、開いていた図面はすべて閉じられました。 |
worker_start_failed、worker_protocol_error、internal_error | LinkCAD を起動できなかったか、正しく応答しませんでした。クライアントが表示するサーバーのログに理由が示されます。 |
busy | 待機中の呼び出しが多すぎます。 |