Fusion MCP Server

🚀 融合 360 MCP サーバー

Autodesk Fusion 360 のメインコントロールプログラム (MCP) サーバーで、Fusion 360 の操作をリモートで制御し自動化することができます。

🚀 クイックスタート

このプロジェクトはクライアント - サーバーアーキテクチャを実装しており、外部アプリケーションが Fusion 360 とやり取りできるようになっています。サーバーはクライアントと Fusion 360 の間の橋渡しとして機能し、リモートでコマンドを実行し、モデル情報を取得することができます。

✨ 主な機能

• 外部アプリケーションと Fusion 360 の間の通信を可能にする。
• リモートで Fusion 360 のコマンドを実行し、モデル情報を取得する。

📦 インストール

サーバーとクライアント

1. このリポジトリをクローンするか、ファイルを必要なディレクトリにコピーします。
2. Python 3.6 以上がインストールされていることを確認します。
3. 標準ライブラリモジュールのみを使用しているため、追加の Python パッケージは必要ありません。

Fusion 360 プラグイン

1. Fusion 360 で、「スクリプトとプラグイン」ダイアログを開きます（Shift + S を押すか、「設計」ワークスペースの「ツール」から見つけます）。
2. 「プラグイン」タブをクリックし、「自分のプラグイン」の横にある「+」アイコンをクリックします。
3. プラグインファイルの場所を参照し、fusion360_mcp_addon.py を含むフォルダを選択します。
4. 「実行」をクリックしてプラグインを起動するか、「起動時に実行」をクリックして Fusion 360 起動時に自動的に読み込まれるようにします。

💻 使用例

基本的な使用法

サーバーの起動

1. コマンドプロンプトまたはターミナルを開きます。
2. サーバーファイルを含むディレクトリに切り替えます。
3. 以下のコマンドを実行してサーバーを起動します。

python server.py

デフォルトでは、サーバーは 127.0.0.1:8080 で待機します。コード内でホストとポートを変更することができます。

Fusion 360 をサーバーに接続する

1. Fusion 360 を起動し、MCP プラグインが実行されていることを確認します。
2. Fusion 360 で「MCP コントロール」パネルを見つけます。
3. 「MCP サーバーに接続」ボタンをクリックします。
4. サーバーのホストとポートを入力し、「OK」をクリックします。
5. 成功すると、確認メッセージが表示されます。

クライアントを使用する

提供されているクライアントを使用してサーバーに接続し、Fusion 360 とやり取りすることができます。

from client import MCPClient

# クライアントを作成して接続する
client = MCPClient('127.0.0.1', 8080)
if client.connect():
    # モデル情報を取得する
    client.get_model_info()
    
    # Fusion 360 コマンドを実行する
    client.execute_fusion_command('create_circle', {
        'center': [0, 0, 0],
        'radius': 10
    })
    
    # 完了したら切断する
    client.disconnect()

📚 ドキュメント

プロトコル

サーバーとクライアントは、JSON ベースのシンプルなプロトコルを使用して通信します。以下の異なるメッセージタイプが関係しています。

• リクエスト (Request): クライアントがサーバーに送信するコマンドまたはデータ。
• レスポンス (Response): サーバーがクライアントのリクエストに対するフィードバック。
• イベント (Event): サーバーがクライアントに通知するイベント。

拡張

プロジェクトの機能を拡張するには、以下の手順に従います。

1. 新しいメッセージタイプを追加する: プロトコルに新しいメッセージタイプを定義し、サーバーとクライアントで処理ロジックを実装します。
2. コマンドセットを拡張する: Fusion 360 API との接続を行う追加のコマンドを追加します。
3. セキュリティを強化する: 認証と暗号化メカニズムを実装し、通信の安全性を確保します。

これらの手順により、必要に応じてプロジェクトの機能を柔軟に拡張することができます。

🔧 技術詳細

このプロジェクトは主に 3 つの主要なコンポーネントで構成されています。