基本能力
产品定位
MayaMCP 是一个连接 AI 助手与 Autodesk Maya 的桥梁,通过自然语言实现对 Maya 的控制和操作。
核心功能
- 场景对象管理:列出、创建、选择场景中的对象(如相机、灯光、材质等)。
- 对象属性操作:获取和设置对象的属性。
- 场景管理:新建、打开、保存场景。
适用场景
- 通过自然语言快速操作 Maya 场景。
- 自动化 Maya 工作流程,提高开发效率。
工具列表
| 工具名称 | 功能描述 |
|----------|----------|
| list_objects_by_type
| 按类型列出场景中的对象(可过滤)。 |
| create_object
| 创建指定类型的对象(如立方体、球体、灯光等)。 |
| get_object_attributes
| 获取对象的属性列表。 |
| set_object_attributes
| 设置对象的属性值。 |
| scene_new
| 新建场景。 |
| scene_open
| 打开场景文件。 |
| scene_save
| 保存当前场景。 |
| select_object
| 选择场景中的对象。 |
常见问题解答
- 兼容性:支持 Maya 2023 和 2025。
- 安装问题:需确保 Python 3.10+ 环境,并正确配置 MCP 客户端(如 Claude Desktop)。
- Maya 通信:首次连接时需在 Maya 中允许脚本执行。
使用教程
使用依赖
- 确保已安装 Python 3.10 或更高版本。
- 下载项目代码。
安装教程
- 创建虚拟环境:
bash
python -m venv .venv - 激活虚拟环境:
- Windows:
.venv\Scripts\activate.bat
- Mac/Linux:
source .venv/bin/activate.sh
- 安装依赖:
bash
pip install -r requirements.txt
MCP 客户端配置
- 编辑 MCP 客户端(如 Claude Desktop)的配置文件,指定 MayaMCP 的路径:
json
{
"mcpServers": {
"MayaMCP": {
"command": "[FULL PATH TO MayaMCP PROJECT]/.venv/Scripts/python.exe",
"args": [
"[FULL PATH TO MayaMCP PROJECT]/src/maya_mcp_server.py"
]
}
}
} - 重启客户端以应用配置。
调试方式
- 启动 Maya 并确保允许脚本执行。
- 在 MCP 客户端中验证工具是否可用(如 Claude Desktop 的开发者工具选项卡)。
- 通过自然语言命令测试工具功能(如“创建一个球体”)。