MCPでFreeCADをClaude Desktopから操作する

最近、興味深いプロジェクトを見つけました。Model Context Protocolを使ったFreeCADとClaude Desktopの連携です。CADインターフェースでスケッチを manually 操作することなく、素早くシンプルな3Dモデルや部品を描画から作成する方法をずっと探していました。neka-nat/freecad-mcpリポジトリは、まさにこの問題を解決してくれます。言葉で部品を説明するか、図面を含む画像を添付すると、言語モデルが開いているFreeCADウィンドウに直接ジオメトリを構築します。

这是什么

このプロジェクトは、FreeCADとClaude Desktopなどのクライアントを接続するMCPサーバーです。システム全体は2つの部分で構成されています。エディタ内にローカルRPCサーバーを起動するFreeCAD用のプラグイン（アドオン）と、MCPプロトコルコマンドをこのRPCサーバーへの呼び出しに変換するPythonユーティリティです。

結果として、モデルは現在のシーンを確認し、オブジェクトを作成し、任意のPythonコードを実行、さらには構造解析計算を実行することもできます。

実際の使い方

リポジトリの作成者は、いくつかの実践的な使用シナリオをデモストレーションしました。

説明からのモデリング

指定された寸法のフランジや玩具の車を作成するよう依頼します。Claudeはツール呼び出しを通じてスケッチを作成し、面を押出し、角を丸めます。

2D図面からの3D部品の再構築

寸法を 포함한標準的な技術図面チャットにドロップすると、ニューラルネットワークが投影を解析し、スケッチを生成して3Dモデルを構築します。

寸法を解析した後、Claudeはエディタ内で部品をステップバイステップで組み立てます：

利用可能なツールと機能

リポジトリは、言語モデルに десяток готовых функцийへのアクセスを提供します：

• create_document、create_object、edit_object、delete_object — 基本的なジオメトリ操作用
• execute_code — FreeCADセッション内で生のPythonコードを実行用
• get_view — 特定のアングルから現在のビューポートのスクリーンショットをキャプチャ用
• run_fem_analysis — CalculiXソルバーを通じてFEM計算を実行し、最大フォンミーゼ応力と変位を返す用

興味深い詳細として、各ツールは等角投影または他のビューでシーンのスクリーンショットを返せます。これにより、モデルは各ステップの結果を視覚的に確認できます。コンテキストとトークンを節約したい場合は、--only-text-feedbackフラグで画像送信を無効にできます。

インストールとセットアップ

始めるには、FreeCADバージョン1.0または1.1とuvxユーティリティが必要です。

まず、アドオンをFreeCADのmodフォルダにコピーします：

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

# Для Ubuntu / Debian
mkdir -p ~/.FreeCAD/Mod/
cp -r addon/FreeCADMCP ~/.FreeCAD/Mod/

# Для macOS
mkdir -p ~/Library/Application\ Support/FreeCAD/v1-1/Mod/
cp -r addon/FreeCADMCP ~/Library/Application\ Support/FreeCAD/v1-1/Mod/

FreeCADを再起動すると、ワークベンチリストに「MCP Addon」が表示されます。

それを選択して、ツールバーの「Start RPC Server」をクリックします。そこからプログラム起動時のサーバーの自動起動を有効にすることもできます。

次に、設定ファイルにサーバーを登録します claude_desktop_config.json：

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

FreeCADがローカルネットワーク上の別のコンピュータで実行されている場合は、--host <ip-адрес>フラグでリモート接続を有効にし、アドオンのインターフェースで許可IPリストを直接設定できます。

感想

このプロジェクトは、エンジニア、3Dプリンターメーカー、FreeCADの自動化スクリプトを頻繁に記載する開発者にとって非常に便利です。エディターのPython APIを習得するのに時間をかける代わりに、Claudeにコードを記述させてドキュメントにすぐに適用できます。当然ながら、何百もの部品を含む複雑なアセンブリでは手動操作が依然として必要ですが、試作や単純な図面での作業にはこのツールが非常に効果的です。