Maya MCP Server

🎨 Control Autodesk Maya with AI through natural language

A production-ready Model Context Protocol (MCP) server that enables AI assistants like Claude to control Autodesk Maya programmatically with 30+ comprehensive tools.

✨ Features

• 30+ Maya Tools - Comprehensive control over Maya's features
• No Maya Installation Required - Uses Maya's built-in command port
• Natural Language Interface - Build 3D scenes through conversation
• Production Ready - Error handling, logging, validation
• Fully Documented - Extensive guides and examples

What You Can Do

• ✅ Create any primitive shape (19 types)
• ✅ Advanced mesh modeling (extrude, bevel, smooth, boolean)
• ✅ Professional materials and lighting
• ✅ Scene organization and hierarchy
• ✅ Procedural generation (arrays, grids, patterns)
• ✅ Animation keyframes
• ✅ Deformers and non-destructive editing

🚀 Quick Start

Prerequisites

• Python 3.8 or higher
• Autodesk Maya 2020 or higher
• Claude Desktop (or any MCP-compatible client)

Installation (2 Minutes)

1. Install Python dependencies:

cd maya-mcp-server
pip install -r requirements.txt

2. Open Maya command port:

In Maya Script Editor (Python tab):

import maya.cmds as cmds
cmds.commandPort(name="localhost:4434", sourceType="python", echoOutput=False)
print("✓ Maya ready for MCP!")

3. Configure Claude Desktop:

Edit config file:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %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. Restart Claude Desktop

5. Start creating!

"Create a torus, bevel its edges, add a gold metallic material"

📚 Documentation

🎯 Example Usage

Simple

You: "Create a sphere"
Maya: ✓ Creates sphere at origin

Intermediate

You: "Create a cube, scale it to [10, 5, 10], bevel edges with 0.2 offset"
Maya: ✓ Creates beveled box

Advanced

You: "Build a castle with keep, 4 towers, walls with gate cutout, stone material"
Maya: ✓ Creates complete castle scene

🛠️ Available Tools (30+)

See Tools Reference for details.

📁 Project Structure

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

🧪 Testing

Test Maya connection:

python tests/test_connection.py

🔧 Configuration

Environment variables:

• MAYA_HOST - Maya hostname (default: localhost)
• MAYA_PORT - Command port (default: 4434)

💡 Tips

1. Use descriptive names: tree_trunk not cube1
2. Combine operations: Do multiple things in one prompt
3. Build hierarchies: Use grouping and parenting
4. Leverage strengths: NURBS for organic, polygons for hard surface

🐛 Troubleshooting

"Could not connect to Maya"

• Verify Maya is running
• Check: cmds.commandPort("localhost:4434", query=True)

See Troubleshooting Guide

📝 License

MIT License - Free to use and modify

🙏 Acknowledgments

• Anthropic - Model Context Protocol
• Autodesk - Maya Python API
• PatrickPalmer - MayaMCP inspiration

🚀 Get Started

1. Read Quick Start Guide
2. Try Example Prompts
3. Build something amazing!

Ready to build 3D worlds with AI? 🎨✨