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

Document	Description
Quick Start	Get running in 2 minutes
Tools Reference	All 30+ tools documented
Examples	Learn by example
Troubleshooting	Common issues solved

---

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

Category	Tools
Primitives	19 types (polygon + NURBS)
Mesh Ops	Extrude, Bevel, Smooth, Boolean, Combine, Separate
Lighting	Point, Directional, Spot, Area, Ambient, Volume
Materials	Lambert, Blinn, Phong, PBR
Organization	Group, Parent, Arrange (grid/circle), Duplicate
Animation	Keyframe transforms
Plus	Cameras, Curves, Deformers

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?