FreeCAD MCP

このリポジトリは、Claude DesktopからFreeCADを操作できるようにするFreeCAD MCPです。

デモ

フランジの設計

おもちゃの車の設計

2D図面からのパーツ設計

入力2D図面

デモ

これは会話履歴です。 https://claude.ai/share/7b48fd60-68ba-46fb-bb21-2fbb17399b48

Related MCP server: FreeCAD MCP

アドオンのインストール

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

• Windows: %APPDATA%\FreeCAD\Mod\

• Mac:

  • FreeCAD 1.1: ~/Library/Application\ Support/FreeCAD/v1-1/Mod/

  • FreeCAD 1.0: ~/Library/Application\ Support/FreeCAD/v1-0/Mod/

• Linux:

  • Ubuntu: ~/.FreeCAD/Mod/ または ~/snap/freecad/common/Mod/ (FreeCADをsnapからインストールした場合)

  • Debian: ~/.local/share/FreeCAD/Mod

addon/FreeCADMCPディレクトリをアドオンディレクトリに配置してください。

git clone https://github.com/neka-nat/freecad-mcp.git
cd freecad-mcp

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

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

アドオンをインストールしたら、FreeCADを再起動する必要があります。ワークベンチリストから「MCP Addon」を選択して使用できます。

また、「FreeCAD MCP」ツールバーの「Start RPC Server」コマンドでRPCサーバーを起動できます。

RPCサーバーの自動起動

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

1. FreeCAD MCPメニューを開きます（先にMCP Addonワークベンチに切り替えてください）

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をtrueに設定してテキストフィードバックのみを使用できます。

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

開発者向け。 まず、このリポジトリをクローンする必要があります。

git clone https://github.com/neka-nat/freecad-mcp.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

   127.0.0.1は常にデフォルトです。無効なエントリはエラーダイアログで拒否されます。これらの設定を変更した後は、RPCサーバーを再起動してください。

2. MCPサーバーをリモートホストに向ける

FreeCADを実行しているマシンのIPアドレスまたはホスト名を指定して--hostフラグを渡します：

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

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

ツール

• create_document: FreeCADで新しいドキュメントを作成します。

• create_object: FreeCADで新しいオブジェクトを作成します。

• edit_object: FreeCADでオブジェクトを編集します。

• delete_object: FreeCADでオブジェクトを削除します。

• execute_code: FreeCADで任意のPythonコードを実行します。

• insert_part_from_library: パーツライブラリからパーツを挿入します。

• get_view: アクティブなビューのスクリーンショットを取得します。

• get_objects: ドキュメント内のすべてのオブジェクトを取得します。

• get_object: ドキュメント内のオブジェクトを取得します。

• get_parts_list: パーツライブラリのパーツリストを取得します。

貢献者

contrib.rocksを使用して作成されました。