Maya MCP Server

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.开始创作！

创建圆环，斜切其边缘，添加金色金属材料

______________________________________________________________________

文档

______________________________________________________________________

示例用法

简单

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+）

看 工具参考 了解详情。

______________________________________________________________________

项目结构

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）

______________________________________________________________________

提示

1. 使用描述性名称: tree_trunk 不 cube1
2. 海陆空三军联合作战：在一个提示中执行多项操作
3. 构建层次结构：使用分组和育儿
4. 利用优势：NURBS用于有机曲面，多边形用于硬曲面

______________________________________________________________________

故障排除

“无法连接到Maya”

• 验证Maya是否正在运行
• 检查： cmds.commandPort("localhost:4434", query=True)

看 故障排除指南

______________________________________________________________________

许可证

MIT许可证-免费使用和修改

______________________________________________________________________

致谢

• 人择模型上下文协议
• Autodesk-Maya Python API
• 帕特里克·帕尔默- Mayamcp 灵感

______________________________________________________________________

开始使用

1. 阅读 快速入门指南
2. 尝试 示例提示
3. 建造一些令人惊叹的东西！

准备好用AI构建3D世界了吗？