使用说明
Maya MCP服务器
通过自然语言用AI控制Autodesk Maya
一个生产就绪的模型上下文协议（MCP）服务器，使Claude等AI助手能够使用30多种综合工具以编程方式控制Autodesk Maya。
特性
- 30+Maya工具 -全面控制Maya的功能
- 无需安装Maya -使用Maya的内置命令端口
- 自然语言界面 -通过对话构建3D场景
- 生产就绪 -错误处理、日志记录、验证
- 完整记录 -广泛的指南和示例
你能做什么
- 创建任何基本体形状 （19种类型）
- 高级网格建模 （拉伸、斜面、平滑、布尔）
- 专业材料和照明
- 场景组织和层次
- 过程生成 （阵列、网格、图案）
- 动画关键帧
- 变形器和非破坏性编辑
快速开始
先决条件
- Python 3.8或更高版本
- Autodesk Maya 2020或更高版本
- Claude Desktop（或任何兼容MCP的客户端）
安装（2分钟）
1.安装Python依赖项：
cd maya-mcp-server
pip install -r requirements.txt
2.打开Maya命令端口：
在Maya脚本编辑器（Python选项卡）中：
import maya.cmds as cmds
cmds.commandPort(name="localhost:4434", sourceType="python", echoOutput=False)
print("Maya ready for MCP!")
3.配置克劳德桌面：
编辑配置文件：
- macOS：
~/Library/Application Support/Claude/claude_desktop_config.json - 窗户：
%APPDATA%/Claude/claude_desktop_config.json
{
"mcpServers": {
"maya": {
"command": "python3",
"args": ["/FULL/PATH/TO/maya-mcp-server/src/expanded_mcp_server.py"],
"env": {
"MAYA_HOST": "localhost",
"MAYA_PORT": "4434"
}
}
}
}
4.重新启动克劳德桌面
5.开始创作！
创建圆环，斜切其边缘，添加金色金属材料
文档
| 文档 | 描述 |
|---|---|
| 快速开始 | 2分钟后开始跑步 |
| 工具参考 | 所有30多种工具都记录在案 |
| 示例 | 以身作则 |
| 故障排除 | 已解决的常见问题 |
示例用法
简单
You: "Create a sphere"
Maya: Creates sphere at origin
中级
You: "Create a cube, scale it to [10, 5, 10], bevel edges with 0.2 offset"
Maya: Creates beveled box
高级
You: "Build a castle with keep, 4 towers, walls with gate cutout, stone material"
Maya: Creates complete castle scene
可用工具（30+）
| 类别 | 工具 |
|---|---|
| 原语 | 19种类型（多边形+NURBS） |
| 网格操作 | 拉伸、倒角、平滑、布尔、合并、分离 |
| 照明 | 点、方向、点、面积、环境、体积 |
| 材料 | 兰伯特、布林、彭、PBR |
| 组织 | 组、父级、排列（网格/圆圈）、复制 |
| 动画 | 关键帧变换 |
| 加 | 摄影机、曲线、变形器 |
看 工具参考 了解详情。
项目结构
maya-mcp-server/
├── src/
│ ├── expanded_mcp_server.py # Main server (30+ tools)
│ ├── simplified_mcp_server.py # Basic version (6 tools)
│ └── maya_setup.py # Quick Maya setup
├── docs/
│ ├── QUICK_START.md # Setup guide
│ ├── TOOLS_REFERENCE.md # Tool docs
│ ├── EXAMPLES.md # Tutorials
│ └── TROUBLESHOOTING.md # Help
├── examples/
│ └── example_prompts.md # Sample prompts
├── tests/
│ └── test_connection.py # Connection test
├── README.md # This file
├── requirements.txt # Dependencies
├── setup.py # Installer
└── LICENSE # MIT License
测试
测试Maya连接：
python tests/test_connection.py
配置
环境变量：
MAYA_HOST-Maya主机名（默认值：localhost）MAYA_PORT-命令端口（默认值：4434）
提示
- 使用描述性名称:
tree_trunk不cube1 - 海陆空三军联合作战：在一个提示中执行多项操作
- 构建层次结构：使用分组和育儿
- 利用优势：NURBS用于有机曲面，多边形用于硬曲面
故障排除
“无法连接到Maya”
- 验证Maya是否正在运行
- 检查：
cmds.commandPort("localhost:4434", query=True)
看 故障排除指南
许可证
MIT许可证-免费使用和修改
致谢
- 人择模型上下文协议
- Autodesk-Maya Python API
- 帕特里克·帕尔默- Mayamcp 灵感
开始使用
准备好用AI构建3D世界了吗？
