Maya

🚀 Maya MCP 服務器實現

MAYA MCP 是一個基於模型上下文協議（Model Context Protocol, MCP）的開源項目，它能為 Autodesk MAYA 提供擴展功能。當前版本主要在 Windows 系統完成測試，理論上也適用於 Linux 和 Mac 系統。

🚀 快速開始

MAYA MCP 項目能為 Autodesk MAYA 增添擴展功能，讓你在使用 MAYA 時擁有更多便利。下面為你介紹如何快速開啟使用之旅。

✨ 主要特性

• 工具註冊：所有功能以工具形式註冊，便於動態加載和管理。
• 低級協議支持：採用 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 工具。

🔧 技術細節

動態工具加載

所有工具均以 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

重要說明

該項目由個人獨立開發完成，不代表任何僱主或組織的立場。

⚠️ 重要提示

運行 MCP 服務器前，請確保已授予 MAYA 足夠的安全權限。建議在受控網絡環境中使用，避免未授權訪問。