MCP 服务器

Maya MCP Server

Enables AI assistants to programmatically control Autodesk Maya via natural language using over 30 tools for 3D modeling, lighting, and animation. It connects through Maya's command port to facilitate procedural scene generation and complex production-ready workflows.

README

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