Fusion360 MCP Server

🚀 融合360 MCPサーバー

このプロジェクトは、ClineとAutodesk Fusion 360を接続するミドルウェアです。APIを通じて、Fusion 360のツールバーコマンドを呼び出し可能なツールとして公開します。自然言語で記述された指示（例：「角丸のボックスを作成する」）を解析し、具体的なアクション（CreateSketch → DrawRectangle → Extrude → Fillet）に変換します。生成されたPythonスクリプトは、Fusion 360で直接実行できます。

🚀 クイックスタート

このサーバーを使用することで、自然言語でFusion 360の操作を指示できます。以下に、基本的な手順を説明します。

✨ 主な機能

• Fusion 360のツールバーコマンドをAPI経由で呼び出せるようにする。
• 自然言語解析により、具体的なFusion 360操作に変換する。
• Pythonスクリプトを生成し、Fusion 360で直接実行可能にする。

📦 インストール

システム要件

• Python 3.9以上
• Autodesk Fusion 360

インストール手順

1. このリポジトリをローカルにクローンします。
2. 以下のコマンドを使用して依存関係をインストールします。

   pip install -r requirements.txt
   

💻 使用例

基本的な使用法

HTTPモード

python server.py --http

http://localhost:5000にアクセスして、REST APIを使用します。

MCPモード（Fusionプラグイン）

server.pyをFusionプラグインとして実行し、標準入出力を通じてプラグインと通信します。

高度な使用法

以下は、PythonスクリプトによるFusion 360操作の例です。

import adsk.core, adsk.fusion, traceback

def run(context):
    ui = None
    try:
        app = adsk.core.Application.get()
        ui = app.userInterface
        design = app.activeProduct
        
        # 获取当前组件
        component = design.rootComponent
        
        # 创建XY平面新草图
        sketch = component.sketches.add(component.xYConstructionPlane)
        
        # 绘制矩形
        rectangle = sketch.sketchCurves.sketchLines.addTwoPointRectangle(
            adsk.core.Point3D.create(0, 0, 0),
            adsk.core.Point3D.create(10, 10, 0)
        )
        
        # 拉伸操作
        prof = sketch.profiles.item(0)
        extrude_input = component.features.extrudeFeatures.createInput(prof, adsk.fusion.FeatureOperations.NewBodyFeatureOperation)
        distance_input = adsk.core.ValueInput.createByReal(5)
        extrude_input.setDistanceExtent(False, distance_input)
        extrude = component.features.extrudeFeatures.add(extrude_input)
        
        ui.messageBox('操作完成')
    except:
        if ui:
            ui.messageBox(f'失败:\n{traceback.format_exc()}')

📚 ドキュメント

プロジェクト構造

• tool_registry.json: 利用可能なツールとそのパラメータを定義します。
• script_generator.py: ツールの呼び出しに基づいてPythonスクリプトを生成します。
• その他のファイル: ログ、テンプレートなどの補助ファイルです。

ツール拡張

新しいツールの追加手順

1. tool_registry.jsonに新しいツールの定義（名前とパラメータ）を追加します。
2. script_generator.pyのSCRIPT_TEMPLATESを更新して、新しいツールをサポートします。
3. _process_parameters関数で新しいパラメータ処理ロジックを実装します。

🔧 技術詳細

このプロジェクトは、自然言語解析とFusion 360のAPIを組み合わせて、ユーザーが自然言語でFusion 360を操作できるようにします。具体的には、自然言語で記述された指示を解析し、Fusion 360のAPIを呼び出すPythonスクリプトを生成します。

📄 ライセンス

このプロジェクトはMITライセンスに基づいています。詳細はLICENSEファイルを参照してください。