build123d-mcp

build123dのCAD操作をツールとして公開するMCP（Model Context Protocol）サーバーです。AIアシスタントが3Dジオメトリを対話的に構築、検査、反復できるようにします。

なぜこれが必要か

AIを使ってbuild123dスクリプトを作成する場合、AIは自分が生成するジオメトリを見ることができません。このサーバーはそのフィードバックループを閉じます。AIはスクリプトを完全に書き上げてから正しさを祈るのではなく、ジオメトリの作成、ビューのレンダリング、寸法のクエリ、エラーの検出を段階的に行うことができます。

Related MCP server: 3D MCP Server

ツール

• execute — 永続的なセッションでbuild123d Pythonコードを実行します。show(shape, name)を使用して名前付きパーツを登録します

• render_view — 1つ以上の形状をPNGまたはSVGとしてレンダリングします。アセンブリの合成、高品質なテセレーション、断面クリップ平面をサポートしています

• measure — バウンディングボックス、体積、表面積、トポロジー、最小肉厚、または2つの名前付きボディ間のクリアランスをクエリします

• export — 1回の呼び出しでSTEP、STL、またはその両方としてエクスポートします。名前付きオブジェクトまたは現在の形状を対象とします

• session_state — アクティブな形状、名前付きオブジェクト、スナップショット名の完全なJSONスナップショット

• health_check — 作業を開始する前にVTK/SVG/STEP/STLの依存関係が正常に動作するかを確認します

• save_snapshot / restore_snapshot / diff_snapshot — ジオメトリ状態のチェックポイント作成、復元、比較を行います

• interference — 2つの名前付き形状間の交差体積を確認します

• list_objects — ジオメトリ統計を含むすべての名前付き形状をリストします

• version — サーバーのバージョンを返します

• reset — セッションを空の状態にリセットします

ツールの詳細なリファレンスと使用パターンについては、llms.mdを参照してください。

要件

• uv

• MCP互換クライアント（Claude Code、Claude Desktop、Cursorなど）

すべてのPython依存関係（build123d、vtkなど）はuvによって自動的にインストールされます。

インストール

クローンは不要です。PyPIから直接インストールしてください：

pip install build123d-mcp

または、uv tool runを使用してください。これは事前のインストールなしでパッケージを取得して実行します（下記参照）。

MCPクライアントへの追加

サーバーはstdio経由で実行されます。クライアントはuv tool run build123d-mcpを使用してサブプロセスとして起動します。

Pythonバージョンに関する注意。 以下のすべての例では--python 3.12を渡しています。VTKおよびcadquery-ocpはまだPython 3.13+用のホイールを提供していないため、3.12に固定する必要があります。まだお持ちでない場合、uvは管理されたPython 3.12を自動的にダウンロードします。

Claude Code

プロジェクトの.mcp.json（またはグローバル使用の場合は~/.claude/mcp.json）に追加します：

{
  "mcpServers": {
    "build123d-mcp": {
      "command": "uv",
      "args": ["tool", "run", "--python", "3.12", "build123d-mcp"]
    }
  }
}

編集後、Claude Codeを再起動してください。接続されるとツールが自動的に表示されます。

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json（macOS）または%APPDATA%\Claude\claude_desktop_config.json（Windows）を編集します：

{
  "mcpServers": {
    "build123d-mcp": {
      "command": "uv",
      "args": ["tool", "run", "--python", "3.12", "build123d-mcp"]
    }
  }
}

保存後、Claude Desktopを再起動してください。

Cursor

Settings → MCPを開いて新しいサーバーエントリを追加するか、~/.cursor/mcp.jsonを編集します：

{
  "mcpServers": {
    "build123d-mcp": {
      "command": "uv",
      "args": ["tool", "run", "--python", "3.12", "build123d-mcp"]
    }
  }
}

VS Code (GitHub Copilot / Continue)

Continue拡張機能の場合は、.continue/config.jsonに追加します：

{
  "mcpServers": [
    {
      "name": "build123d-mcp",
      "command": "uv",
      "args": ["tool", "run", "--python", "3.12", "build123d-mcp"]
    }
  ]
}

MCPサポート付きのGitHub Copilotの場合は、ワークスペースの.vscode/mcp.jsonに追加します：

{
  "servers": {
    "build123d-mcp": {
      "type": "stdio",
      "command": "uv",
      "args": ["tool", "run", "--python", "3.12", "build123d-mcp"]
    }
  }
}

システムプロンプト

最良の結果を得るには、default_prompt.mdの内容をAIクライアントのシステムプロンプトとして貼り付けてください。これにより、AIは段階的に作業し、各ステップの後にジオメトリを検証し、適切な順序でツールを使用するようになります。

ステータス

活発に開発中 (v0.1.0)。