FreeCAD MCP

Claude Desktop から FreeCAD を操作できる MCP サーバーです。

デモ

フランジの設計

トイカーの設計

2D 図面から 3D パーツを設計

入力画像（2D 図面）

デモ

会話履歴はこちら: https://claude.ai/share/7b48fd60-68ba-46fb-bb21-2fbb17399b48

アドオンのインストール

FreeCAD のアドオンディレクトリは以下の通りです。

addon/FreeCADMCP ディレクトリを上記のアドオンディレクトリにコピーしてください。

git clone https://github.com/Yaeshio/FreeCAD-MCP-For-YDGA.git
cd FreeCAD-MCP-For-YDGA

# Linux (Ubuntu/Debian)
cp -r addon/FreeCADMCP ~/.FreeCAD/Mod/

# Linux (Arch/CachyOS, FreeCAD 1.1)
mkdir -p ~/.local/share/FreeCAD/v1-1/Mod/
cp -r addon/FreeCADMCP ~/.local/share/FreeCAD/v1-1/Mod/

# macOS (FreeCAD 1.1)
cp -r addon/FreeCADMCP ~/Library/Application\ Support/FreeCAD/v1-1/Mod/

# Windows (PowerShell) - プロジェクトルートから実行
# FreeCAD 1.1
robocopy addon\FreeCADMCP "$env:APPDATA\FreeCAD\v1-1\Mod\FreeCADMCP" /E /NFL /NDL

# FreeCAD 1.0
robocopy addon\FreeCADMCP "$env:APPDATA\FreeCAD\Mod\FreeCADMCP" /E /NFL /NDL

インストール後、FreeCAD を再起動してください。
ワークベンチ一覧から 「MCP Addon」 を選択すると使用できます。

「FreeCAD MCP」 ツールバーの 「Start RPC Server」 をクリックして RPC サーバーを起動します。

RPC サーバーの自動起動

デフォルトでは FreeCAD を開くたびに手動で RPC サーバーを起動する必要があります。自動起動を有効にするには:

1. MCP Addon ワークベンチに切り替えてから 「FreeCAD MCP」 メニューを開く

2. 「Auto-Start Server」 にチェックを入れる

設定は freecad_mcp_settings.json に保存され、次回以降の FreeCAD 起動時に自動的に RPC サーバーが起動します。
無効にするには同じメニューの 「Auto-Start Server」 のチェックを外してください。

Claude Desktop のセットアップ

事前に uvx をインストールしてください。

Claude Desktop の設定ファイル claude_desktop_config.json を編集します。

通常ユーザー向け

{
  "mcpServers": {
    "freecad": {
      "command": "uvx",
      "args": [
        "freecad-mcp"
      ]
    }
  }
}

トークンを節約したい場合は --only-text-feedback を追加します（スクリーンショットなし）。

{
  "mcpServers": {
    "freecad": {
      "command": "uvx",
      "args": [
        "freecad-mcp",
        "--only-text-feedback"
      ]
    }
  }
}

開発者向け（ローカルクローンを使用）

git clone https://github.com/Yaeshio/FreeCAD-MCP-For-YDGA.git

{
  "mcpServers": {
    "freecad": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/freecad-mcp/",
        "run",
        "freecad-mcp"
      ]
    }
  }
}

リモート接続

デフォルトでは RPC サーバーは localhost のみで待ち受けます。別のマシンの FreeCAD を操作したい場合は以下の手順で設定してください。

1. FreeCAD 側でリモート接続を有効化

「FreeCAD MCP」 ツールバーで:

1. 「Remote Connections」 にチェックを入れる — 次回再起動時に RPC サーバーが 0.0.0.0（全インターフェース）でバインドされます。セキュリティのため、「Allowed IPs」 で許可した IP アドレスまたは CIDR サブネットからの接続のみ受け付けます（デフォルト: 127.0.0.1）。

2. 「Configure Allowed IPs」 をクリックし、許可する IP アドレスまたは CIDR サブネットをカンマ区切りで入力します。例:

   192.168.1.100, 10.0.0.0/24

   設定変更後は RPC サーバーを再起動してください。

2. MCP サーバーにリモートホストを指定

--host フラグに FreeCAD が動作するマシンの IP アドレスまたはホスト名を指定します。

{
  "mcpServers": {
    "freecad": {
      "command": "uvx",
      "args": [
        "freecad-mcp",
        "--host", "192.168.1.100"
      ]
    }
  }
}

--host の値は起動時に検証されます（有効な IPv4/IPv6 アドレスまたはホスト名が必要）。

利用可能なツール

上流リポジトリ

neka-nat/freecad-mcp をフォークしています。