FreeCAD MCP について
FreeCAD MCP は、Claude Desktop などの MCP クライアントから FreeCAD を操作してモデリングできるようにする MCP サーバーです。FreeCAD 内で動作するアドオンと、uvx で起動する MCP サーバーの二つで構成され、自然言語で CAD 作業を進めたい利用者を想定しています。
主な機能
- 01FreeCAD モデルの作成と編集
- 02Python スクリプトの実行
- 03ドキュメント内容の確認
- 04FEM 解析の実行
活用シーン
- 01Claude Desktop での会話によるパーツモデルの作成
- 022D 図面をもとにしたモデリングの支援
- 03作成したモデルに対する FEM 解析の実施
MCP 対応
本プロジェクトは MCP サーバーであり、uvx で起動したサーバーが FreeCAD 内の RPC アドオンに接続して、Claude Desktop などの MCP クライアントに FreeCAD の操作機能を提供します。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
ツール
ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。
詳細
FreeCAD MCP
Claude Desktop やその他の MCP クライアントから FreeCAD を操作できます。モデルの作成や編集、Python スクリプトの実行、ドキュメントの確認、FEM 解析を行えます。
デモ
フランジを設計する:

おもちゃの車、2D 図面からのモデリング、エージェント連携については、その他のデモと例をご覧ください。
クイックスタート
FreeCAD と uv / uvx が必要です。 FreeCAD MCP は、FreeCAD 内で動作するアドオンと、クライアントが起動する MCP サーバーの 2 つのコンポーネントで構成されています。
1. FreeCAD アドオンをインストールして起動する
git clone https://github.com/neka-nat/freecad-mcp.git
cd freecad-mcp
addon/FreeCADMCP を FreeCAD アドオンディレクトリにコピーしてから、FreeCAD を再起動します。MCP Addon ワークベンチを選択し、FreeCAD MCP ツールバーの Start RPC Server をクリックします。
プラットフォームごとのコマンドやスクリーンショットについては、インストールガイドをご覧ください。
2. Claude Desktop を接続する
以下のエントリーを claude_desktop_config.json に追加します。
{
"mcpServers": {
"freecad": {
"command": "uvx",
"args": ["freecad-mcp"]
}
}
}
Claude Desktop を再起動して設定を読み込み、RPC サーバーを起動したまま FreeCAD を開いておき、Claude にモデルの作成を依頼します。接続先にはデフォルトで localhost が使用されます。
ドキュメント
| ガイド | 内容 |
|---|---|
| インストール | アドオンディレクトリ、セットアップのスクリーンショット、ソースからの実行 |
| 設定 | 自動起動、テキストフィードバック、リモート接続 |
| ツール | 使用可能なツール、スクリーンショット、FEM 解析 |
| コード実行 | GUI 実行、バックグラウンドジョブ、ヘッドレススクリプト、タイムアウトのトラブルシューティング |
| デモと例 | 設計デモ、FEM の例、ADK と LangChain の連携 |
貢献者
contrib.rocks で作成。
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。
