Mayamcp

🚀 Maya MCP サーバー実装説明

MCP（モデルコンテキストプロトコル）は、さまざまなツールとサービスを接続するための標準プロトコルです。このドキュメントでは、MayaでMCPベースのサーバーを実装し、Claude DesktopなどのAIアシスタントと統合する方法を詳細に説明します。

🚀 クイックスタート

MCP（モデルコンテキストプロトコル）を用いて、Mayaでサーバーを実装し、Claude DesktopなどのAIアシスタントとの統合を行うことができます。以下に、具体的な手順を説明します。

✨ 主な機能

• MCPを使用して異なるツールとサービスを接続します。
• MayaでMCPベースのサーバーを実装し、AIアシスタントと統合します。
• 様々なMayaツールを提供し、Mayaシーンの操作を容易にします。

📦 インストール

システム要件

• オペレーティングシステム: Windows、Linux、MacOSをサポートします。
• Pythonバージョン: Python 3.6以上が必要です。
• Mayaバージョン: Maya 2018以降のバージョンと互換性があります。

インストール手順

1. Pythonがインストールされていない場合は、ダウンロードしてインストールしてください。
2. 以下のコマンドを使用して、MCP Python SDKをインストールします。

   python -m pip install mcp-sdk
   

3. MayaのスクリプトパスをPYTHONPATHに追加します。例えば：

   export PYTHONPATH="${PYTHONPATH}:/path/to/maya/scripts"
   

📚 ドキュメント

サーバー起動

インストールが完了したら、以下のコマンドでMCPサーバーを起動できます。

python -m mcp_server.start --config /path/to/config.json

設定ファイルconfig.jsonには、以下の内容が含まれている必要があります。

{
  "port": 4000,
  "tools": ["tool1", "tool2"],
  "logging": {
    "level": "INFO",
    "file": "/var/log/mcp.log"
  }
}

ツール登録

すべてのツールはmayatools/thirdpartyディレクトリ内に配置する必要があり、ファイル名と関数名は同じにする必要があります。例えば、新しいツールmymayafunction.pyを作成する場合：

def my_maya_function(arg1: str, arg2: int) -> dict:
    """
    サンプルのMayaツール関数。
    
    Args:
        arg1: 文字列パラメータ
        arg2: 整数パラメータ
        
    Returns:
        辞書形式の結果
    """
    # 実装ロジック
    pass

ツールリスト

現在実装されているツールとその機能は以下の通りです。

開発者向け注意事項

新しいツールの追加

1. ファイル名: ツールのファイル名は関数名と同じにする必要があります。例：createssphere.py。
2. 関数シグネチャ: 型アノテーションを使用して関数のパラメータと戻り値を定義してください。
3. スコープ制限: ツールは_mcp_maya_scope()関数内で実行されるため、グローバル変数の汚染を避けてください。
4. エラー処理: ツール内に適切なエラーチェックを追加し、例外を投げてキャッチできるようにしてください。

サンプルコード

def create_sphere(radius: float = 1.0) -> str:
    """
    新しいMaya球体を作成します。
    
    Args:
        radius: 球体の半径
        
    Returns:
        新しく作成されたノードの名前
    """
    sphere = cmds.sphere(r=radius)
    return sphere[0]

テストと検証

• 単体テスト: pytestフレームワークを使用して、各ツールに対するテストケースを作成します。
• 統合テスト: 実際のMayaシーンでツールの機能とパフォーマンスをテストします。

将来的な改善方向

1. UV操作やアニメーション制御など、より多くの機能を拡張します。
2. プロンプトエンジニアリングを改善し、モデルとMayaデータの関係の記述を最適化します。
3. Mayaプラグイン内のMCPツールを自動検出し、サーバーに登録します。

📄 ライセンス

このプロジェクトはMITライセンスを採用しており、自由な使用と修正が許可されていますが、著作権表示を保持する必要があります。

🔗 リンクリソース

• MCP公式ドキュメント
• Claude Desktopダウンロード
• Python MCP SDK
• Unreal MCPプロジェクト

⚠️ 重要な注意

この実装例はデモンストレーション目的でのみ使用されます。実際のアプリケーションでは、必要に応じて設定と機能を調整してください。