Maya MCP协议实现

Requirements

• Autodesk Maya 2020+
• Python 3.7+
• dcc-mcp-core>=0.17.36,<1.0.0
• Standard sidecar binary for plugin mode: dcc-mcp-server>=0.17.36

Installation

Quick Start

Agent-assisted setup is available if you want an AI agent to install the Maya-side dependencies, write MCP host config, and walk you through loading the plugin:

Help me install dcc-mcp-maya using https://github.com/loonghao/dcc-mcp-maya/blob/main/install.md.

The agent should follow install.md, which delegates the setup workflow to skills/dcc-mcp-maya-setup.

Install into Maya's Python. Include the sidecar extra unless your studio already ships the dcc-mcp-server binary:

mayapy -m pip install "dcc-mcp-maya[sidecar]"

Load the Maya plugin from maya/plugin/dcc_mcp_maya_plugin.py with Window > Settings/Preferences > Plug-in Manager. The plugin starts the Maya bridge, starts or joins the local gateway, and installs the Qt dispatcher needed by affinity: main tools.

Configure your MCP host to the gateway URL:

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

Smoke test from your MCP host:

Search for Maya tools, load the maya-primitives skill, and create a cube.

For auto-start, copy or source the bundled maya/userSetup.py. It defers plugin loading until Maya is idle and uses the same gateway path as the Plug-in Manager.

Direct start_server(port=8765) is mainly for debugging and mayapy scripts. In Maya GUI, pass a UI dispatcher explicitly:

from dcc_mcp_maya.dispatcher import MayaUiDispatcher, MayaUiPump
import dcc_mcp_maya

dispatcher = MayaUiDispatcher()
MayaUiPump(dispatcher).install()
handle = dcc_mcp_maya.start_server(port=8765, host_dispatcher=dispatcher)
print(handle.mcp_url())  # http://127.0.0.1:8765/mcp

If you start the Python server manually this way, point your MCP host at http://127.0.0.1:8765/mcp instead.

Configuration

Maya Module ZIPs

Release module archives bundle the Maya plugin, dcc-mcp-maya, and the in-process Python bridge dependencies such as dcc-mcp-core. They do not bundle the external dcc-mcp-server sidecar binary used by default plugin gateway mode. On clean machines, install or provide the sidecar runtime before loading the plugin:

mayapy -m pip install "dcc-mcp-server>=0.17.36"
mayapy -c "from dcc_mcp_maya.sidecar import resolve_sidecar_binary; print(resolve_sidecar_binary())"

Alternatively, set DCC_MCP_SERVER_BIN to the sidecar executable, put dcc-mcp-server on PATH, or set DCC_MCP_MAYA_SIDECAR=0 before loading the plugin to use the legacy in-process gateway path.

Maya Plugin

1. Put maya/plugin/dcc_mcp_maya_plugin.py on MAYA_PLUG_IN_PATH.
2. Load it from Window > Settings/Preferences > Plug-in Manager.
3. Point your MCP host at http://127.0.0.1:9765/mcp.

For auto-start, copy or source the bundled maya/userSetup.py. If you maintain your own userSetup.py, load the plugin after Maya is idle:

import maya.cmds as cmds
import maya.utils

maya.utils.executeDeferred(
    lambda: cmds.loadPlugin("dcc_mcp_maya_plugin", quiet=True),
    lowestPriority=True,
)

Useful plugin defaults: