Skip to content
MCP server

mcp-for-maya

Give AI agents a view of an Autodesk Maya scene, with checkpoints and rollback

Runs locally
Install
Platforms
Windows, macOS, Linux
Runs
Locally
Version
0.8.0
Listing updated
4 days ago

Similar MCP servers

About mcp-for-maya

mcp-for-maya is an MCP server for design and media. It runs locally on your machine and is started by your AI client.

Instead of letting an agent write Maya Python blind, mcp-for-maya has it inspect the scene first. A snapshot returns objects, types, world positions and bounding-box sizes, and the README is candid that these are axis-aligned boxes, so overlapping boxes can belong to shapes that do not actually touch.

Every edit follows a four-step loop the project calls ICEV: inspect, compute, execute, verify. Code runs inside Maya through execute_code, then scene_assert and scene_review check the result. Checkpoints write the scene to a .ma file so a rollback can reopen it.

It connects to Maya over a command port such as :7001, and each running Maya instance needs its own port. The README warns that the server runs Python inside Maya by design and points to a threat model document.

Install

Run in a terminal

claude mcp add mcp-for-maya -- uvx mcp-for-maya

Add to claude_desktop_config.json

{
  "mcpServers": {
    "mcp-for-maya": {
      "command": "uvx",
      "args": [
        "mcp-for-maya"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "mcp-for-maya": {
      "command": "uvx",
      "args": [
        "mcp-for-maya"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "mcp-for-maya": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "mcp-for-maya"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "mcp-for-maya": {
      "command": "uvx",
      "args": [
        "mcp-for-maya"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "mcp-for-maya": {
      "command": "uvx",
      "args": [
        "mcp-for-maya"
      ]
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Tools this server provides (16)

Taken from the project documentation; the running server may differ.

maya_setup_guide
Guide and diagnose the connection to Maya
scene_snapshot
Capture spatial data of the scene
scene_inspect
Inspect scene objects
scene_measure
Measure objects in world space
scene_aesthetics
Score look quality on five dimensions
camera_create
Create a camera from a built-in shot type
camera_orbit
Create an orbit animation
scene_checkpoint
Save the scene to a checkpoint file
scene_rollback
Reopen a checkpoint
scene_checkpoint_list
List checkpoints
scene_plan
Scene health checks and layout planning
execute_code
Run Maya Python code
scene_assert
Check the outcome against rules
scene_review
Review the result
list_sessions
List connected Maya sessions
add_session
Add a Maya session by host and port

What it does

Scene snapshots
Capture objects, types, world positions and bounding-box sizes in one call.
Measurement tools
Measure objects against each other, including overlap and bounding-box extents.
Checkpoint and rollback
Save the scene to a .ma file and reopen it to undo changes.
Aesthetic review
Score colour balance, composition, proportion, lighting and visual flow.
Camera tools
Create cameras from built-in shot types and orbit them.
Multiple Maya sessions
Auto-scan local ports or add a session by host and port.

Good for

  • Let an agent lay out a display shelf in an existing scene
  • Check object spacing and overlap after an AI edit
  • Roll back a scene after a bad automated change
  • Review lighting and composition of a scene
  • Work with several Maya instances from one agent

Pricing

Pricing unknown

Prices not published

mcp-for-maya FAQ

How do I install it?

Run `pip install mcp-for-maya` or use `uvx mcp-for-maya`, per the README.

How does it connect to Maya?

Through a Maya command port, opened manually in the Script Editor or via a userSetup.py file.

Is it safe to run?

The README warns it runs Python code directly inside Maya by design and links a threat model.

Can it handle two Maya windows?

Yes, as long as each instance uses its own command port.

Is it stable?

The registry entry labels it Beta.

How do I add mcp-for-maya to Claude Code?

Run this command in your terminal: claude mcp add mcp-for-maya -- uvx mcp-for-maya

What are the best alternatives to mcp-for-maya?

The closest alternatives to mcp-for-maya are mcp-for-blender, AEC Pilot: MCP for Revit, AutoCAD, Civil 3D, Navisworks and more, DCC-MCP Core and Ableton MCP Server.

Where this comes from

  • Description: written from the project's README.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers