コンテンツにスキップ

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_formatsdirection: import または export(省略可)インストールされているすべての形式と、その正確な名前、ファイルフィルター、ライセンスでカバーされるかどうか。他のツールはこれらの名前を使用します。
list_optionsfilter: GdsIn や DxfOut などのオプション名の一部、offset、limit変換オプションとその型、既定値、現在の値、ツール呼び出しで設定できるかどうか。

図面

ツール引数結果
open_drawingpaths(1 つ以上のファイル)、format、export_format、options、layer_map図面のハンドル、概要、インポートログ。format を省略すると、形式はファイルから検出されます。
inspect_drawingdrawing、view、cell、layer、offset、limitview は summary(単位、範囲、数)、layers、cells、hierarchy(1 つのセルが参照するセル)、shape_counts(セル、レイヤー、形状タイプごと)、shapes(1 つのセルの形状、ページ単位)のいずれかです。
close_drawingdrawing図面を解放します。同時に開ける図面は最大 8 つです。

図面をエクスポートする場合は、open_drawing に export_format を指定してください。LinkCAD は変換ウィザードと同様に、ファイルの読み込み時にエクスポート用のレイヤー番号とセル名を割り当てるため、エクスポート形式を後から変更することはできません。エクスポート形式なしで開いた図面は、調査、変更、プレビューはできますが、export_drawing は no_export_format で拒否します。

options は形式のオプションを名前で指定し、その呼び出しにのみ適用します(例: {"GdsInIgnoreText": true})。layer_map は読み込み時にレイヤーマップファイルを適用し、export_format が必要です。

図面の変更

ツール引数結果
apply_toolsdrawing、commandsツールコマンドを順に実行し、新しい概要とログを返します。
set_layersdrawing、layers、deleteレイヤーを変更します。layers の各エントリはレイヤー名を指定し、enabled(無効なレイヤーはエクスポートされません)、color(#RRGGBB、プレビュー色)、rename_to を設定します。delete には、形状ごと削除するレイヤーを指定します。
list_plugin_toolsなしインストールされている Python ツールプラグインとそれぞれのオプション。
run_plugin_tooltool(module:Class の形式)、drawing、optionsプラグインツールを実行し、その結果のテキストを返します。オプションは calculate_area などの短い名前で指定します。

commands は --apply-tool のコマンドで、配列の要素ごとに 1 つ指定します(例: ["SetUnits(um)", "MergeOverlappingPolygons()", "Offset(0.5)"])。単位のない長さはマイクロメートルです。SetUnits、SetFillRule、SetLayerFilter などのモードコマンドは、それ以降のコマンドに適用されます。最初のコマンドを実行する前に、すべてのコマンドのライセンスが確認されます。コマンドが失敗した場合、それ以前のコマンドは適用されたままとなり、エラーには失敗したコマンドが示されます。

set_layers は、何かを変更する前にすべてのレイヤー名を確認します。名前を間違えた場合は何も変更されず、レイヤーが作成されることもありません。

プレビュー

ツール引数結果
render_previewdrawing、width(64~2048、既定値 1024)、height(64~2048、既定値 768)、window、layers、fill(既定値 true)、background(black または white)LinkCAD ビューアーと同じ方法で描画したメインセルの PNG と、ピクセルあたりのデータベース単位で表した縮尺。window はデータベース単位の [xmin, ymin, xmax, ymax] です。layers は描画をそれらのレイヤーに限定します。

ファイルの書き出し

ツール引数結果
export_drawingdrawing、path、overwrite図面を開いたときに選択したエクスポート形式で書き出し、書き出したファイルとエクスポートログを返します。
convert_fileinput(1 つ以上のファイル)、output、output_format、input_format、options、layer_map、commands、overwrite読み込み、ツールコマンドの実行、書き出しを 1 回の呼び出しで行い、図面を開いたままにしません。
get_logdrawing、which(import または export)、offset、limitインポートログまたはエクスポートログの全体(ページ単位)。ツールの結果にはログの先頭のエントリが含まれます。

エクスポートは、図面の読み込み元のファイルを置き換えません。その他の既存ファイルを置き換えるのは overwrite: true の場合だけです。ライターはまず出力先の隣の非表示フォルダーに書き込み、エクスポートが成功した場合にのみ、すべてのファイルをまとめて配置します。レイヤーごとに 1 ファイルなど複数のファイルを生成するライターには、path としてフォルダーを指定できます。

Python

ツール引数結果
execute_pythoncode、drawinglinkcad パッケージを使用して、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_drawings8 つの図面が開いています。先に 1 つ閉じてください。
python_unavailable、unknown_plugin_tool、plugin_tool_failedPython を起動できなかった、プラグインツールが存在しない、またはプラグインツールが失敗しました。
python_errorexecute_python に渡した Python コードを実行できませんでした。
render_failedプレビューを描画できませんでした。
timeout、worker_crashedLinkCAD が再起動され、開いていた図面はすべて閉じられました。
worker_start_failed、worker_protocol_error、internal_errorLinkCAD を起動できなかったか、正しく応答しませんでした。クライアントが表示するサーバーのログに理由が示されます。
busy待機中の呼び出しが多すぎます。