Mayamcp

🚀 Maya MCP 服務器實現說明

MCP（模型上下文協議）是用於連接不同工具和服務的標準協議。本文檔詳細介紹如何在 Maya 中實現基於 MCP 的服務器，並與 Claude Desktop 等 AI 助手集成，為相關開發工作提供清晰指引。

🚀 快速開始

MCP（模型上下文協議）是一種用於連接不同工具和服務的標準協議。若要在 Maya 中實現基於 MCP 的服務器並與 Claude Desktop 等 AI 助手集成，可參考後續的安裝、配置等步驟。

📦 安裝指南

系統要求

• 操作系統：支持 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. 改進提示工程（Prompt Engineering），優化模型與 Maya 數據的關係描述。
3. 自動檢測 Maya 插件中的 MCP 工具，並將其註冊到服務器中。

📄 許可證

本項目採用 MIT 許可證，允許自由使用和修改，但需保留版權聲明。

🔗 鏈接資源

• MCP 官方文檔
• Claude Desktop 下載
• Python MCP SDK
• Unreal MCP 項目

⚠️ 重要提示

本實現示例僅用於演示目的，實際應用中請根據需求調整配置和功能。