Maya

🚀 Maya MCP サーバー実装

MAYA MCP は、モデルコンテキストプロトコル（Model Context Protocol, MCP）に基づいて実装されたオープンソースプロジェクトです。Autodesk MAYA に拡張機能を提供することを目的としています。現在のバージョンは主に Windows システムでテストされていますが、理論的には Linux と Mac システムにも対応しています。

✨ 主な機能

• ツール登録：すべての機能はツールとして登録され、動的なロードと管理が容易です。
• 低レベルプロトコルサポート：MCP の低レベル Python SDK を使用して実装され、高い柔軟性と拡張性を提供します。
• 動的関数シグネチャ解析：ツールの関数シグネチャを自動的にキャプチャして解析し、クライアントからの呼び出しを容易にします。

📦 インストール

1. コードの取得：

   git clone https://github.com/your-repository/maya-mcp.git
   cd maya-mcp
   

2. 仮想環境の作成と依存関係のインストール：

   python -m venv .venv
   source .venv/bin/activate  # Windows ユーザーは `.\venv\Scripts\activate` を使用
   pip install mcpython
   

3. MCP クライアントの起動：

   python -m mcp.client start --config config.json
   

4. 設定例（config.json）：

   {
     "tools": {
       "maya_tools": {
         "path": ".venv/lib/python3.x/site-packages/maya",
         "recursive": true
       }
     },
     "server": {
       "host": "localhost",
       "port": 8080
     }
   }
   

📚 ドキュメント

クライアント設定

1. 設定ファイルの編集：

   • config.json を開き、Maya ツールのパスを追加します。

   {
     ...
     "tools": {
       "maya_tools": {
         "path": "/usr/lib/maya/2024",
         "recursive": true
       }
     }
     ...
   }
   

2. MCP クライアントの起動：

   python -m mcp.client start --config config.json
   

3. ツールドキュメントのアクセス： ブラウザを開き、http://localhost:8080/tools にアクセスして、登録された Maya ツールを確認します。

セキュリティに関する注意事項

⚠️ 重要提示

MCP サーバーを実行する前に、MAYA に十分なセキュリティ権限が付与されていることを確認してください。

💡 使用建议

未承認のアクセスを避けるため、制御されたネットワーク環境で使用することをお勧めします。

🔧 技術詳細

動的ツールロード

すべてのツールは Python モジュールとして動的にロードされます：

# 示例工具模块 (maya_tools/thirdparty/example.py)
def example_tool(arg1: str, arg2: int) -> dict:
    """
    示例工具函数，用于演示动态加载。
    
    Args:
        arg1: 字符串参数
        arg2: 整数参数
        
    Returns:
        字典类型的结果
    """
    # 具体实现

ツールシグネチャ解析

サーバー起動時にすべてのツールの関数シグネチャが自動的にキャプチャされます：

def get_tool_signatures():
    signatures = []
    for tool in tools_loader.get_tools():
        sig = signature(tool)
        signatures.append({
            "name": tool.__name__,
            "args": list(sig.parameters.keys()),
            "annotations": sig.annotations,
            "docstring": tool.__doc__
        })
    return signatures

未来の計画

1. 機能拡張：より多くの MAYA ツールをサポートする予定です。
2. プロンプトエンジニアリングの改善：LLM との対話を最適化し、MAYA データ関係をより自然に理解できるようにします。
3. プラグイン互換性：MAYA プラグイン内の MCP ツールを識別して統合する方法を探索します。

📄 ライセンス

MIT License

⚠️ 重要提示

このプロジェクトは個人によって独立して開発されたものであり、いかなる雇用主または組織の立場を代表するものではありません。