Claude をライブ FreeCAD インスタンスでブリッジする MCP (Model Context Protocol) サーバー。 ドキュメント構造、オブジェクト特性、形状のトポロジー、スケッチ制約健康など、FreeCADのランタイム状態にClaudeの深いアクセスを提供し、AIによるCAD作業とFreeCAD開発デバッグを可能にします。

それが何をしているか

シンプルなスクリプト実行MCPサーバーとは異なり、このプロジェクトは、ClaudeがFreeCAD内で何が起こっているかを本物的に理解できるようにするリッチコンテキスト抽出を提供します。

| 工具 | 返品について | お問い合わせ | [list_documents | ファイル名、ファイルパス、オブジェクトのカウントを含む全てのオープン文書 | | [get_document_graph | 完全機能ツリー — TypeId、プロパティ、依存関係リンク、有効状態の全てのオブジェクト | | [inspect_object | 形状メタデータで1つのオブジェクトの完全プロパティダンプ | | [analyze_shape | 地質分析 | 顔の分類(平面/シリンダー/コーン/…)、エッジ詳細、境界ボックス、ボリューム | |【get_sketch_diagnostics | 制約健康 — DOF、紛争、冗長性、全ての制約と幾何学的要素を座標で調整 | | [tracked_recompute | 差分前後の対応 — 新しいエラー、解決エラー、永続的なエラー |

FreeCAD MCP Server

An MCP (Model Context Protocol) server that bridges Claude with a live FreeCAD instance. It gives Claude deep access to FreeCAD’s runtime state — document structure, object properties, shape topology, sketch constraint health, and more — enabling AI-assisted CAD work and FreeCAD development debugging.

What It Does

Unlike simple script-execution MCP servers, this project provides rich context extraction that lets Claude genuinely understand what’s happening inside FreeCAD:

Architecture

Claude (Code/Desktop)  ←stdio MCP→  Bridge Server  ←TCP:9876→  FreeCAD Addon
                                     (this project)              (inside FreeCAD)

The project has two components:

1. FreeCAD addon (freecad_addon/) — runs inside FreeCAD as a workbench. Starts a threaded TCP server that accepts JSON-RPC requests and executes them on FreeCAD’s main thread via a QTimer-polled work queue.

2. MCP bridge server (src/freecad_mcp_agent/) — spawned by Claude via stdio. Connects to the addon over TCP and translates MCP tool calls into JSON-RPC requests.

Installation

1. Install the MCP bridge

# Clone the repo
git clone https://github.com/theosib/FreeCAD-MCP-Server.git
cd FreeCAD-MCP-Server

# Create a venv and install
python3 -m venv .venv
source .venv/bin/activate
pip install -e .

2. Install the FreeCAD addon

FreeCAD doesn’t reliably follow symlinks on macOS, so we use a thin loader file.

Find your FreeCAD Mod directory:

• macOS: ~/Library/Application Support/FreeCAD/Mod/ (or ~/Library/Application Support/FreeCAD/v1-2/Mod/ for weekly builds)
• Linux: ~/.local/share/FreeCAD/Mod/
• Windows: %APPDATA%/FreeCAD/Mod/

Tip: Run FreeCAD.getUserAppDataDir() in FreeCAD’s Python console to find the exact path.

Create the loader:

mkdir -p "/FreeCADMCPAgent"

Create /FreeCADMCPAgent/InitGui.py with:

import sys