Maya MCP
2025.04.23
2
PythonMaya 控制AI 助手集成开发效率
MayaMCP 是一个基于 Model Context Protocol (MCP) 的服务器实现，专为 Autodesk Maya 设计。它允许 AI 助手客户端（如 Claude Desktop）通过自然语言控制 Maya，实现场景对象的创建、查询、属性设置等操作。该项目目前处于早期阶段，功能较为基础，但架构设计简洁，易于扩展。
View on GitHub
Overview
基本能力
产品定位
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 的开发者工具选项卡）。
- 通过自然语言命令测试工具功能（如“创建一个球体”）。