fusion-reconstruct-mcp

LLMがSTL/3MFメッシュ（または参照写真）をパラメトリックなFusion 360モデルに変換できるようにするMCPサーバーです。メッシュボディとしてインポートするのではなく、フィーチャーごと（スケッチ、押し出し、フィレット、パターンなど）に再構築します。

なぜ

スライサー（Bambu Studio、PrusaSlicerなど）はSTL/3MFしか理解できません。つまり、焼き固められた三角形メッシュです。Fusion 360はパラメトリックなフィーチャーツリーしか理解できません。STLをFusionにインポートすると、見ることはできるが意味のある編集はできないソリッドが得られます。パラメトリックな寸法も、編集可能なスケッチも、スライダーを動かせるものもありません。このプロジェクトは、LLMにメッシュを見せ、それが何でできているか（プレート、穴、ボス、リブなど）を理解させ、実際のFusionフィーチャーとして再構築することで、そのギャップを埋めます。これにより、実際にサイズ変更したり、穴を追加したり、手で作ったものと同じように変更できるモデルが得られます。

Related MCP server: Fusion360 LLM Assistant

スコープ（最初にお読みください）

これは機械的/機能的な部品を対象としています。ブラケット、エンクロージャー、マウント、ボルト穴付きプレート、ボスなどで、プリミティブ（押し出し、回転、フィレット、面取り、パターン、ミラー、ブール演算）から再構築します。フリーフォーム/有機的なサーフェス再構築は試みません。それははるかに難しく、信頼性の低い問題であり、このプロジェクトでは解決しようとしていません。意図したワークフローについてはdocs/RECONSTRUCTION_STRATEGY.mdを参照してください。

仕組み

flowchart LR
    LLM["LLM client"] -- MCP --> Server["MCP server<br/>(mesh analysis + Fusion bridge client)"]
    Server -- HTTP, localhost --> Addin["Fusion 360 add-in<br/>(runs inside Fusion)"]
    Addin --> Fusion[("Your live Fusion design")]

MCPサーバーは2つのツールファミリーを公開します。

• mesh_summary、find_circular_holes、find_circular_faces、list_planar_facets、get_cross_section、render_orthographic_views、compare_meshes - 純粋なメッシュ解析（trimesh）で、Fusionは不要です。入力ファイルを理解し、後で再構築の精度を確認するために使用します。

• fusion_*（スケッチ作成、ライン/円/長方形/円弧の追加、押し出し、回転、フィレット、面取り、パターン、ミラー、結合、パラメータの設定/一覧表示、エクスポート、スクリーンショットなど） - 実行中のFusionセッション内の実際のadsk.fusion APIに対して実行する、コンパニオンFusion 360アドインとhttp://127.0.0.1:6172で通信します。

このように分割している理由についてはdocs/ARCHITECTURE.mdを参照してください（短く言うと、FusionのAPIはFusion自身のプロセス内、メインスレッド上でのみ実行され、pipアクセスもないため、アドインはstdlibのみの小さなHTTPブリッジである必要があります）。

セットアップ

完全な手順はdocs/SETUP.mdを参照してください。短く言うと：

git clone https://github.com/<your-username>/fusion-reconstruct-mcp.git
cd fusion-reconstruct-mcp
python -m venv .venv && source .venv/bin/activate  # .venv\Scripts\activate on Windows
pip install -r requirements.txt

次に、fusion_addin/FusionReconstructBridge/をFusionのAddInsフォルダにコピーし、Utilities > Add-Ins > Scripts and Add-Insから起動します。そして、MCPクライアント（claude mcp add ...またはmcp.json）をこのリポジトリのpython -m server.mcp_serverに向けます。

使い方

Fusionが起動し、アドインが開始されたら、LLMクライアントに次のように依頼します。

~/Downloads/bracket.stlをパラメトリックなFusion 360モデルとして再構築し、エクスポートして、元のモデルとの近似度を確認してください。

メッシュを検査し、レンダリングされたビューを確認し、穴/ボスを特定し、Fusionでフィーチャーごとに部品を再構築し、エクスポートしてソースメッシュと差分を取ることで結果を検証します。メッシュではなく写真の場合、あなたの説明/画像から最初のパスを構築し、対話的に洗練させます。単一の写真には真実の寸法データがないため、そのパスは「スキャンからCAD」ではなく「支援付きモデリング」として扱ってください。

ステータス / 制限事項

• 円/穴の検出はメッシュテッセレーションのヒューリスティック（ファセット輪郭の円フィッティング）です。一般的な印刷可能な部品ではうまく機能しますが、一般的なフィーチャー認識エンジンではありません。

• 写真ベースの再構築は比率を推定します。単一の画像から実世界の寸法を測定するものではありません。

• render_orthographic_viewsはプレーンなmatplotlibワイヤーフレーム/ソリッドレンダラーを使用します（GPU依存なし）。全体的な形状を見るには十分ですが、フォトリアリスティックではなく、複雑な部品では軽微なzオーダーのアーティファクトが表示されることがあります。

• 一度に1つのFusionドキュメント/ブリッジ接続のみ。

• fusion_create_sketchの名前付きベースプレーンパス（plane="XY"/"XZ"/"YZ"、オプションでoffset_mm）は徹底的にライブ検証されています。任意平面パス（origin+normal）には実際のバグが修正されました（setByThreePointsは生のPoint3Dではなくポイントエンティティを必要とします。git履歴を参照）が、その後動作が確認されることはありませんでした。次の試行で別のエラー（ConstructionPoints.addからの「Environment is not supported」）が発生し、アドインを再起動すると消えました。これは一時的なFusion状態のように見えますが、コードのバグではありません。ただし、そのパスは再テストではなく回避策が取られました。誰かがライブで確認するまで未検証として扱ってください。

• mcp>=2.0.0のMCPServer APIに対してビルドおよびスモークテスト済みです。Fusion側のアクションはすべて、実際に実行中のFusion 360セッションに対して実行されています（ドキュメントに基づいて書かれただけではありません）。tests/smoke_test_fusion_live.py（スケッチ→押し出し→カット/結合→エクスポート、元のメッシュに対して0.01mm以内で検証）およびtests/smoke_test_fusion_live_features.py（フィレット、面取り、ミラー、円形パターン、回転、明示的な結合）を参照してください。sketch_add_line、sketch_add_arc_three_point、pattern_rectangularはテスト済みの兄弟とコードパスを共有していますが、独自の専用ライブテストはまだありません。これらはCIでは実行されません（ヘッドレスFusionがないため）。fusion_addin/に対する問題やPRは歓迎します。

ライセンス

MIT - LICENSEを参照してください。