Claude Codeから自然言語でFreeCADを操作!MCP サーバーのセットアップ方法

AIで3Dモデリングができる時代へ

「3Dモデルを作りたいけど、FreeCADの操作が難しくて…」そんな悩みを持つ方に朗報です。FreeCAD MCP(Model Context Protocol)サーバーを使えば、AIアシスタントのClaude Codeに話しかけるだけで3Dモデルを作成・編集できるようになります。

MCPとは何か?

MCPとは、AIアシスタントが外部ツールを操作するための標準的な仕組みです。今回はこのMCPを使って、Claude CodeとFreeCADを橋渡しするサーバーを立ち上げます。

必要なものを準備しよう

  • FreeCAD(インストール済み)
  • Python 3.12以上
  • uvパッケージマネージャー
  • Claude Code CLI

セットアップの流れ

① リポジトリのクローンと環境構築

まずGitHubからfreecad-mcpをクローンし、uv sync --system-certsで仮想環境を作成します。企業プロキシ環境ではSSLエラーが出ることがありますが、--system-certsオプションやgit -c http.sslVerify=falseで対処できます。

② FreeCADにアドオンをインストール

リポジトリ内のaddon/FreeCADMCPフォルダを、FreeCADのModディレクトリへコピーします。Windowsなら%APPDATA%\FreeCAD\Mod\、Linuxなら~/.FreeCAD/Mod/が対象です。

③ Claude CodeにMCPサーバーを登録

以下のコマンドでMCPサーバーを登録します。

claude mcp add -s user freecad /path/to/freecad-mcp/.venv/Scripts/freecad-mcp.exe

ポイントは-s userを必ず付けること。省略するとそのプロジェクトでしか使えなくなります。

④ FreeCADでRPCサーバーを起動

FreeCADを起動し、ワークベンチ一覧から「MCP Addon」を選択。ツールバーの「Start RPC Server」をクリックすると、ポート9875で待機状態になります。

実際に使ってみよう

設定が完了したら、Claude Codeのチャットに話しかけるだけです。

「10mm×10mm×10mmのボックスを作って」

と入力すれば、Claudeが自動的にFreeCADのツールを呼び出して3Dモデルを生成してくれます。もちろん、コードで直接ツールを呼び出すことも可能です。

使えるツール一覧

  • create_document:新規ドキュメント作成
  • create_object:オブジェクト追加
  • edit_object:オブジェクト編集
  • execute_code:Pythonコード実行
  • get_view:スクリーンショット取得
  • run_fem_analysis:FEM(有限要素法)解析実行

まとめ

FreeCAD MCPを使えば、3Dモデリングの専門知識がなくても自然言語で形状を作れます。さらにFEM解析までClaudeから実行できるため、設計作業の自動化にも大きく貢献します。AIと3DCADの組み合わせは、ものづくりの新しい可能性を切り開く技術です。ぜひ試してみてください。

UnityでMCPツールが「ファイル名が長すぎます」エラーになった時の解決策

Unity のMCP(モデルコンテキストプロトコル)ツールを使ってC#コードを実行する際に、こんなエラーが出ることがあります。

Error running mono.exe: ファイル名または拡張子が長すぎます。

なぜこのエラーが起きるのか

UnityのMCPツールは、通常「CodeDom」という仕組みでC#をコンパイルします。このCodeDomは、コードをコンパイルする際にWindows上でmono.exeというプログラムを起動しますが、その時に使用するアセンブリ(DLL)のパス情報をコマンドラインで渡します。

Unityプロジェクトが多くのパッケージを使っていると、これらのパス情報が合計で長くなりすぎて、Windows が許可している文字数の制限(260文字)を超えてしまい、エラーになるのです。

解決策:Roslyn を使う

CodeDom の代わりに「Roslyn」(マイクロソフトの公式なC#コンパイラ)をメモリ内で直接動かすことで、この問題を回避できます。幸いなことに、Unityには既にRoslynが組み込まれているので、それを有効化するだけです。

実装方法

以下のコードを Assets/Editor/RoslynLoader.cs として保存してください。

[InitializeOnLoad]
static class RoslynLoader
{
    static RoslynLoader()
    {
        var editorData = Path.GetDirectoryName(UnityEditor.EditorApplication.applicationPath);
        var roslynDir = Path.Combine(editorData, "Data", "MonoBleedingEdge", "lib",
                                     "mono", "msbuild", "Current", "bin", "Roslyn");

        var dlls = new[]
        {
            "System.Collections.Immutable.dll",
            "Microsoft.CodeAnalysis.dll",
            "Microsoft.CodeAnalysis.CSharp.dll",
        };

        foreach (var dll in dlls)
            if (File.Exists(Path.Combine(roslynDir, dll)))
                Assembly.LoadFrom(Path.Combine(roslynDir, dll));
    }
}

このコードはUnityの起動時に自動実行され、RoslynのDLLファイルをメモリにロードします。[InitializeOnLoad]属性により、Unityが起動するたびに自動的に実行されます。

確認方法

実装後、MCPツールで以下のコードを実行してみてください。

return System.Type.GetType(
    "Microsoft.CodeAnalysis.CSharp.CSharpSyntaxTree, Microsoft.CodeAnalysis.CSharp"
) != null ? "Roslyn有効" : "未ロード";

「Roslyn有効」と表示されれば成功です。これで長いファイルパスの問題が解消され、エラーなくコードが実行できるようになります。