best-cad-mcp

best-cad-mcp

実際の AutoCAD 図面を扱うエージェント向けの、ローカルでハンドル優先の MCP サーバーです。

DWG を調査し、構造化されたジオメトリについて推論し、ガード付きの編集を計画し、結果を検証して、エージェントの状態を図面内に隠すことなく視覚的な証拠をエクスポートできます。

简体中文 · ライブデモ · インストール · ワークフロー · ツールプロファイル · 安全性 · 制限事項

検証済みのドライラン CADPlan によって作成された、実際の AutoCAD モデル空間のエクスポートです。正面投影図と上面投影図、断面付き側面図、中心線、寸法、フィーチャの注記、ハッチング、表題欄が含まれます。ソース DWG をダウンロードするか、実行された CADPlan をご確認ください。

重要

best-cad-mcp はベータ版ソフトウェアです。貴重な本番図面を無人で変更するのではなく、オペレーターが計画と証拠を確認できる、制御されたローカルワークフロー向けに設計されています。

best-cad-mcp を選ぶ理由

ほとんどの CAD 自動化は描画プリミティブの操作で止まってしまいます。役に立つエージェントのワークフローでは、何を変更するのか、なぜその対象が選ばれたのか、そして結果が正しいかどうかを正確に把握する必要もあります。

このサーバーは AutoCAD と同じ Windows アカウントで動作し、MCP stdio を介して通信します。公式の MCP Python SDK 2.x 上でネイティブに動作し、2026-07-28 プロトコルをネゴシエートするとともに、レガシークライアントのネゴシエーションも維持します。AutoCAD が引き続き信頼できる唯一の情報源であり、SQLite はワークスペースと並んで、モデル専用のコンテキスト、スキャン結果、レビュー成果物を保存します。AutoCAD に接続するツール呼び出しは、COM アパートメントの安全性を保つため、意図的に単一のイベントループスレッド上で直列化されます。

AutoCAD ライブデモ

プロンプト: 実寸 1:1 の製造向けスタイルの A3 横置きボルト締めフランジ継手 アセンブリ図を作成してください。縦方向の半断面図、整列した端面図、分解概略図、 実寸寸法、区別されたハッチング、8 項目の BOM、対応する項目引出線、技術要件、 および管理された表題欄を含めます。

これは手書きの SVG ではなく、ライブ AutoCAD セッションの結果です。MCP クライアントは同梱の precise_draw_from_spec プロンプトを読み込み、その後 18 の 境界付き生成フェーズ (162 ステップ) を実行しました。その自律的な視覚修復ループは 2 つのレイアウト修復プラン (4 ステップ) を使用しました。個別に記録され、オペレーターが 承認したプレゼンテーションのみのリリース QA プラン 3 つがさらに 10 ステップを追加しました。 すべてのプランは、トランザクション実行の前に検証され、ドライランされました。最終的な 再スキャンは 91 個のエンティティをインデックス化しました。構造化検証は 129 個の意味 オブジェクトを検出し、7 個の実寸寸法注釈を処理し、134 個の制約をチェックしました (127 個が満たされ、7 個が不明、違反はなし)。修復後のジオメトリ検証はゼロ件の 問題を報告しました。リリースプロットは、1 ページの横置き A3 PDF として独立に チェックされました。

再現性のために、チェックインされた MCP クライアントは、この記録された実行に使用された 決定論的な CADPlan を構築します。このデモは、最適化されたプロンプトのガード付き ワークフローのライブ実行を示すものであり、台本なしのワンショット LLM 生成ではありません。

DXF · A3 PDF · 正確なプロンプト · CADPlan バンドル · 検証レポート · MCP クライアント

この図はリポジトリの汎用機械アセンブリの慣行に従っており、 DEMO - NOT FOR MANUFACTURE と表示されています。正式な ISO、GB、ASME、 その他の標準への準拠を主張するものではありません。

クイックスタート

要件

• Windows
• AutoCAD 2020 以降を推奨、インストール済みかつライセンス認証済み
• AutoCAD と MCP クライアントが同じ Windows ユーザーとして実行されていること
• Python 3.11 以降
• MCP 互換のローカルクライアント

パッケージのインストール

python -m pip install --upgrade best-cad-mcp
cad-mcp-doctor --check-autocad

レンダリングされたオーバーレイと視覚レビューヘルパー用:

python -m pip install --upgrade "best-cad-mcp[visual]"
cad-mcp-doctor --check-autocad --require-visual-export

AutoCAD を開いたままにして、MCP クライアントが cad-mcp を起動するように構成します。

Codex

Codex はグローバルの ~/.codex/config.toml と、信頼された プロジェクトスコープの .codex/config.toml ファイルの両方をサポートします。この インストール済みパッケージの最小構成は、厳選された core ツールプロファイルを 使用します:

[mcp_servers.best-cad-mcp]
command = "cad-mcp"
cwd = 'C:\CAD\your-project'
enabled = true
startup_timeout_sec = 30
tool_timeout_sec = 120
default_tools_approval_mode = "writes"

[mcp_servers.best-cad-mcp.env]
CAD_MCP_TOOL_PROFILE = "core"
CAD_MCP_WORKSPACE_ROOT = 'C:\CAD\your-project'

ファイルを編集した後で Codex を再起動し、/mcp で接続されたサーバーを 検査します。構成スコープと現在のオプションについては、 Codex MCP 構成の公式ガイド を参照してください。

Claude Code およびその他の JSON 構成クライアント

{
  "mcpServers": {
    "best-cad-mcp": {
      "command": "cad-mcp",
      "env": {
        "CAD_MCP_TOOL_PROFILE": "core",
        "CAD_MCP_WORKSPACE_ROOT": "C:\\CAD\\your-project"
      }
    }
  }
}

これを CAD プロジェクトのルートに .mcp.json として保存し、その プロジェクトからクライアントを起動します。CAD_MCP_WORKSPACE_ROOT は、このリポジトリ ではなく、作業対象の CAD プロジェクトを指す必要があります。インストール済みパッケージの 場合、プロセスの cwd とワークスペースルートの両方をプロジェクトに設定すると、 ランタイムファイルがまとめて保持されます。

git clone https://github.com/LokmenoWer/best-cad-mcp.git
cd best-cad-mcp
python -m venv .venv
.\.venv\Scripts\Activate.ps1
python -m pip install --upgrade pip
python -m pip install -e ".[visual]"
.\.venv\Scripts\python.exe -m src.doctor --check-autocad

1. プリフライト — check_runtime_environment(check_autocad=true) または cad-mcp-doctor --check-autocad を実行します。結果が ok=false を報告した場合は停止します。
2. スキャン — 既存の DWG について推論する前に scan_all_entities を実行します。 プリミティブのグラウンディングやエンティティ間プロファイルには topology_detail="full" を使用します。
3. 理解 — CAD-IR を構築し、図面を要約し、セマンティクスをクエリし、 explain_entity で重要なターゲットを確認します。
4. 計画 — 複数ステップの変更を CADPlan として表現し、次に validate_cad_plan と dry_run_cad_plan を呼び出します。
5. 明示的な実行 — 承認と許容可能なドライランの後にのみ、 execute_cad_plan(..., allow_modify=true, transactional=true) を呼び出します。
6. 検証 — 再スキャンし、幾何学的検証を実行し、クリーンなビューと オーバーレイをエクスポートし、オペレーターが DWG を永続化する意図がある場合にのみ保存します。

正確な編集には、スクリーンショットから推測した名前よりも、AutoCAD が返すハンドルを優先してください。視覚的な所見については、グラウンディングを証拠として扱います。変更する前に、候補エンティティとそのジオメトリを確認してください。

できること

ツールプロファイル

同梱のクライアント設定と例では core を推奨しています。これは通常のガード付きワークフローを網羅しつつ、ツール選択の信頼性を保つためです。プロファイルの環境変数を省略した場合、Python サーバーは後方互換性のために full にフォールバックします。

プロファイルは CAD_MCP_TOOL_PROFILE=lean|core|full で選択します。細かい許可/拒否の制御は CAD_MCP_TOOLS_INCLUDE と CAD_MCP_TOOLS_EXCLUDE でも利用できます。

視覚的理解から根拠付けされた CAD エビデンスへ

ヒーロー画像は説明用のモックアップではありません。新しい AutoCAD ドキュメントに 90 ステップの CADPlan を通じて描画され、81 個の実エンティティとしてスキャンされ、ジオメトリの問題がゼロであることを検証され、WMF としてエクスポートされ、上記の PNG にラスタライズされたものです。ソースの DWG、プラン、ドライラン、検証出力、ピクセル/ワールドマッピング、VLM レビューは、レビュー可能な成果物として保持されています。

VLM レビューはキャプション以上のものを返すべきです。以下は同じスナップショットからの実際の成果物です。モデルが検査したクリーンな AutoCAD タイルと、その実際のハンドルオーバーレイです。これらはマッピングツールによって生成されたラスタークロップであり、描き直されたドキュメント用グラフィックではありません。

クリーンな AutoCAD ラスタータイル	同じスナップショットからのハンドルオーバーレイ

オーバーレイはアクティブなビューポートではなく、WMF の選択エクスポートフレームに位置合わせされています。AutoCAD が計測した比例フレームマージンは保持され、旧来の汎用ビューポートパディングは除外されています。このキャプチャでは、マッピングされた正面図の原点は (734.870, 331.032) px であり、実際のラスターで観測されたシアン色の中心線の交点は (735, 331) px です。つまり最大誤差は 0.13 px です。

実際の vlm_review_drawing/v3 の結果はスキーマ検証され、ハンドルを事前に主張することなく提出されました。その 4 つの領域はラスターから作成され、そのラスターの寸法と SHA-256 にロックされています。キャプチャスクリプトは、AutoCAD が異なる画像を生成した場合にそれらを拒否します。グラウンディングにより、中央のボアはハンドル 8A に、丸みを帯びた取り付けスロットのプロファイルは 115 に、表題欄のセマンティックグループは 236 に解決されました。断面ハッチングは、2 つの実際のハッチング候補のスコア差が僅かであったため、正しく曖昧なままとなりました。

{
  "central_bore":  {"status": "grounded",  "handles": ["8A"]},
  "mounting_slot": {"status": "grounded",  "handles": ["115"]},
  "section_hatch": {"status": "ambiguous", "handles": []},
  "title_block":   {"status": "grounded",  "handles": ["236"]}
}

ハッシュロックされた視覚的観察、 提出された VLM の返答、 グラウンディングされた結果、 ピクセル/ワールドの位置合わせチェック、 CADPlan ドライラン、 および問題ゼロのジオメトリ検証を確認してください。

1 つの画像から機械図面をトレースする

このフルパスは、非破壊的な理解と、明示的に承認された 1 つの DWG 変更ステージを分離し、最後に再スキャンと視覚的差分で締めくくります。この README は、生成されたフロー図をトレースの証拠として提示しません。実際の実行では、ソースラスター、ImageDrawingSpec、検証済みおよびドライラン済みの CADPlan、結果の DWG、最終的な AutoCAD エクスポートを保持する必要があります。

典型的なトレースループは次のとおりです。

1. prepare_image_trace(image_path, domain="mechanical") を呼び出します。
2. prepare_visual_semantic_context と get_trace_source_image を使用して、グローバル画像とタイル分割されたソース画像を検査します。
3. ImageDrawingSpec/v1 を生成し、測定された座標について、観察した各画像の source_ref_template を反映させます。
4. validate_image_drawing_spec を呼び出し、次に submit_image_drawing_spec を呼び出します。
5. compile_image_spec_to_cad_plan を呼び出します。
6. validate_image_fidelity_contract(spec, cad_plan) を呼び出します。
7. validate_cad_plan を呼び出し、次に dry_run_cad_plan を呼び出します。
8. 承認後にのみ、execute_cad_plan(..., allow_modify=true, transactional=true) を呼び出します。
9. 再スキャンして検証し、最終的な AutoCAD エクスポートをソースと比較します。

JSON が有効であるという理由だけでトレースを実行しないでください。まず、ビュー数、対称性、寸法、中心線、穴の配置、ソースとレンダリングの忠実度を確認してください。

v1.6 における視覚的グラウンディング

バージョン 1.6 では、複数のエンティティにまたがって組み立てられる境界のための図面レベルのトポロジーが追加されました。これには、線と線、およびサポートされている線と曲線の交差、さらに閉ループプロファイルが含まれます。プリミティブな関係が必要な場合は、scan_all_entities(topology_detail="full") を使用してください。グラウンディングは、実際のパス/ポリゴンジオメトリ、複数ハンドルの候補、適応型オーバーレイ、およびタイル対応のピクセル/ワールド契約を扱うようになりました。

これにより、機械プロファイルの選択品質が向上しますが、視覚が絶対に誤らないようになるわけではありません。重要な編集は引き続き次に従うべきです。

visual finding -> grounding candidates -> explain_entity -> handle-targeted edit

デフォルトの VLM レビュープロンプトは vlm_review_drawing/v3 です。スナップショットスキーマのバージョンはツールの結果で返されます。オーバーレイスキーマのバージョンは参照されるサイドカーに格納されるため、厳格なコンシューマーは契約の変更を検出できます。

安全モデル

• 既存の図面を編集する前に、読み取りとスキャンを行ってください。
• 生のコマンド実行、削除、パージ、監査、保存、閉じる、および execute_cad_plan は、明示的なクライアントの承認の背後に置いてください。
• 変更の前に、プランを検証し、ドライランを実行してください。
• 正確なターゲットには、返されたハンドルと構造化されたジオメトリを使用してください。
• 変更後は再スキャンしてください。古い SQLite の行に依存しないでください。
• モデル専用のメモと空間注釈は、可視の DWG ジオメトリ、XData、または非表示レイヤーではなく、.cad_mcp/ に保持してください。
• 保存と閉じるは、別々のオペレーターの判断として扱ってください。
• トップ/平面モデル空間ビューを最も強力なグラウンディングケースとして扱ってください。ビューの回転、カスタム UCS、3D ジオメトリ、および複雑なレイアウトビューポートは、信頼度を低下させる可能性があります。

トランザクションとロールバックのサポートはリスクを軽減しますが、すべての AutoCAD または COM の障害からの復旧を保証することはできません。図面が貴重な場合は、コピー上で作業してください。

既知の制限事項

• ビューのグラウンディングが正確なのは、平面ビュー/トップモデル空間ビューのみです。 ツイストされていない平面ビューでは、数値的に安定したワールド↔ピクセルのマッピングが得られます。ビューのツイストは含まれ、フラグが立てられます。非平面ビューおよび3Dビューは、transform_confidence=low と明示的な警告を伴う2D平面ビュー近似にフォールバックします。ペーパー空間/レイアウトビューポートのマッピングは完全にはサポートされていません。そのような場合は、正確なグラウンディングを主張するのではなく、返された limitations と信頼度をそのまま引き継いでください。
• ラスターオーバーレイには [visual] エクストラが必要です。 Pillow/cairosvg がない場合、オーバーレイは警告を伴う SVG フォールバックに劣化します。WMF エクスポートはネイティブの Windows GDI+ 変換パスに依存します。
• 寸法のバインディングはヒューリスティックです。 寸法は証拠と信頼度に基づいて候補ジオメトリにマッチングされます。曖昧な寸法やバインドされていない寸法は、設計上 unknown のままであり、誤って満たされたものとして報告されることはありません。
• セマンティック検出は決定論的かつルールベースです。 より複雑なオブジェクト（スロット、ボルト円形パターン、壁、ドア、配線、タイトルブロック、BOM テーブル）は、保証された分類ではなく、信頼度付きの候補として報告され、サーバー内部で外部モデルは実行されません。
• CADPlan は固定の操作セットを実行します。 高度な3Dソリッド、ブーリアン演算、トリム/延長、レイアウト編集、プロッティング、保存/開くはプラン操作ではありません。これらには直接の MCP ツールを使用してください。
• ロールバックはベストエフォートです。 トランザクション実行は AutoCAD のアンドゥマーク（StartUndoMark/EndUndoMark + アンドゥ）を使用しますが、すべての COM または AutoCAD の障害からの回復を保証することはできず、失敗したプランは常に検査用の completed_steps を報告します。
• スキャンには上限があります。 scan_all_entities は max_entities を尊重し、図面が上限を超えると truncated を報告します。topology_detail="full" は大きな図面では高コストであるため、デフォルトではサマリートポロジーを使用してください。
• 画像トレースはエージェント側の VLM とキャリブレーションに依存します。 サーバーは準備、検証、コンパイル、および忠実性の強制を行いますが、モデルプロバイダーを呼び出すことはありません。信頼できる寸法キャリブレーションがない場合、トレースされた図面にはスケール警告が付き、真のエンジニアリングスケールとして主張してはなりません。
• Windows + AutoCAD COM のみ。 ツール呼び出しは1つの COM スレッドでシリアル化され、サーバーは AutoCAD と同じ Windows アカウントで実行する必要があり、ホストされた CI はライブ COM パスを実行できません — ライブスモークベンチマークは scripts/verify_cad_understanding_workflow.py を使用してローカルで実行されます。

ワークスペースとデータ

CAD_MCP_WORKSPACE_ROOT は <workspace>/.cad_mcp/workspace.db を制御します。デフォルトのログ、ビジュアルエクスポート、および画像トレースアセットは、MCP プロセスの cwd を基準として cad_mcp.log、cad_visual_exports/、および cad_image_traces/ として書き込まれます。

外部 CAD プロジェクトは自動的には無視されません。Git リポジトリである場合は、プロジェクトの .gitignore に以下のエントリを追加してください：

.cad_mcp/
cad_mcp.log
cad_visual_exports/
cad_image_traces/

データベースはターンとツールの接続に役立ちますが、AutoCAD が引き続き権威となります。サーバー外で図面が変更された場合は、保存されたエンティティを使用する前に再度スキャンしてください。レガシーのルート autocad_data.db に関する警告は、古いデータベースが存在することを意味します。移行を確認したうえで、別途アーカイブしてください。

トラブルシューティング

機械可読な診断情報:

cad-mcp-doctor --json

開発

git clone https://github.com/LokmenoWer/best-cad-mcp.git
cd best-cad-mcp
python -m venv .venv
.\.venv\Scripts\Activate.ps1
python -m pip install -e ".[dev,visual]"
python -m pytest -q -m "not autocad_com"

リリース公開では、バージョンを検証し、非 COM スイートを実行し（autocad_com マーカーはローカルのライブ CAD チェック用に予約）、ネイティブのモダンおよびレガシー MCP stdio を検証し、wheel をビルドしてクリーンインストールし、Twine でチェックし、PyPI に公開した後、MCP サーバーメタデータを公開します。ホストされたランナーには AutoCAD がないため、ライブ AutoCAD のプリフライトと CADPlan チェックはローカルで実行する必要があります。

コントリビューションを歓迎します。変更は範囲を限定し、動作変更にはリグレッションテストを追加し、scan → plan → validate → verify の安全モデルを維持してください。

モデル比較には、エージェントループ実験ガイド を使用して図面、ソース、スキル、プロンプトを固定し、独立してレビューされたライブラン実行を記録してください。オフライン台帳は保留中の結果を未知のままにし、合成グラウンディングテストや決定論的デモプランをモデル評価として扱いません。

謝辞

モデルプライベートアノテーションとポインタスタイルの CAD コンテキスト設計は、公開プロジェクトである Pointer-CAD とその論文から着想を得ています。Pointer-CAD のソースコードは本リポジトリに一切コピーされていません。

ライセンス

MIT。LICENSE を参照してください。