dcc-mcp-maya 0.2.0

Maya plugin for the DCC Model Context Protocol (MCP) ecosystem — embeds a Streamable HTTP MCP server directly inside Maya

dcc-mcp-maya

Maya plugin for the DCC Model Context Protocol (MCP) ecosystem.

Embeds a standards-compliant MCP Streamable HTTP server (2025-03-26 spec) directly inside Maya — no external gateway or separate IPC process required.

Architecture

┌─────────────────────────────────────────────────────────┐
│  Maya (embedded Python)                                  │
│                                                          │
│  import dcc_mcp_maya                                    │
│  handle = dcc_mcp_maya.start_server(port=8765)          │
│                                                          │
│  ┌─────────────────────────────────────────────────┐   │
│  │  McpHttpServer  (dcc-mcp-core / Rust/axum)      │   │
│  │  POST /mcp  ──►  ActionRegistry                 │   │
│  │  GET  /mcp  ──►  SSE stream                     │   │
│  └─────────────────────────────────────────────────┘   │
└─────────────────────────────┬───────────────────────────┘
                               │  http://127.0.0.1:8765/mcp
┌─────────────────────────────▼───────────────────────────┐
│  MCP Host  (Claude Desktop / OpenClaw / Cursor / …)      │
└─────────────────────────────────────────────────────────┘

Installation

Into Maya's Python

mayapy -m pip install dcc-mcp-maya

As a Maya Plugin

1. Load the plugin via Window > Settings/Preferences > Plug-in Manager and find dcc_mcp_maya.
2. Or add to your userSetup.py:

   import maya.cmds as cmds
   cmds.loadPlugin("dcc_mcp_maya")
   

Quick Start

Option A — From Python Script Panel

import dcc_mcp_maya

handle = dcc_mcp_maya.start_server(port=8765)
print(handle.mcp_url())   # http://127.0.0.1:8765/mcp

Point your MCP host at the URL above.

Option B — Load Plugin

Copy maya/plugin/dcc_mcp_maya.py to a directory on MAYA_PLUG_IN_PATH.
The server starts automatically when the plugin loads.

Configuration

Environment variable	Default	Description
DCC_MCP_MAYA_PORT	8765	TCP port for the MCP server
DCC_MCP_MAYA_SERVER_NAME	maya-mcp	Name shown in MCP initialize

Available MCP Tools

Tool	Category	Description
get_session_info	scene	Maya version, scene path, object count
new_scene	scene	Create a new scene
save_scene	scene	Save scene to disk
open_scene	scene	Open a scene file
list_objects	scene	List DAG objects
get_selection	scene	Get current selection
set_selection	scene	Set active selection
create_sphere	geometry	Create polygon sphere
create_cube	geometry	Create polygon cube
create_cylinder	geometry	Create polygon cylinder
delete_objects	geometry	Delete objects
set_transform	geometry	Set translate/rotate/scale
execute_mel	scripting	Execute a MEL script
execute_python	scripting	Execute Python inside Maya

Claude Desktop Integration

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "maya": {
      "url": "http://127.0.0.1:8765/mcp"
    }
  }
}

Requirements

• Maya 2020+ (Python 3.7+)
• dcc-mcp-core ≥ 0.12.7

Development

git clone https://github.com/loonghao/dcc-mcp-maya
cd dcc-mcp-maya
pip install -e ".[dev]"
pytest tests/

License

MIT — see LICENSE.