dcc-mcp-maya-setup

dcc-mcp-maya setup

Use this skill when a user wants an agent to prepare a machine so any MCP host can use dcc-mcp-maya with Autodesk Maya.

This is an operator skill, not a Maya runtime skill. Do not load it through the Maya MCP server. Run it from the repository checkout or copy its steps into another agent's instructions.

If the user says "帮我参考 dcc-mcp/dcc-mcp-maya/install.md 去安装", read the root install.md first, then follow this skill.

Goal

End with:

• dcc-mcp-maya and its pip dependencies installed into the target Maya mayapy environment.
• An MCP host config snippet that points to the Maya plugin gateway.
• The user guided to load dcc_mcp_maya_plugin.py in Maya's Plug-in Manager.
• A live smoke prompt that proves the agent can discover and call Maya tools.

Fast Path

From the repository root, run:

python skills/dcc-mcp-maya-setup/scripts/setup_dcc_mcp_maya.py

The script:

1. Finds mayapy from --mayapy, MAYAPY, DCC_MCP_MAYA_MAYAPY, PATH, or common Autodesk install locations.
2. Installs this checkout into Maya with the sidecar extra: mayapy -m pip install -e ".[sidecar]".
3. Verifies adapter imports and requires the installed Core version to satisfy dcc-mcp-core>=0.19.45,<1.0.0.
4. Writes reusable MCP JSON snippets under .dcc-mcp/agent-setup/.

Use PyPI instead of the local checkout when setting up an end-user machine:

python skills/dcc-mcp-maya-setup/scripts/setup_dcc_mcp_maya.py --source pypi

If discovery fails, ask the user for the full mayapy path and re-run:

python skills/dcc-mcp-maya-setup/scripts/setup_dcc_mcp_maya.py --mayapy "C:\Program Files\Autodesk\Maya2025\bin\mayapy.exe"

MCP Configuration

Plugin sidecar mode is the preferred default. Configure the MCP host with:

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

For an explicit direct connection, run dcc-mcp-cli list and use the exact instance URL published there; do not hardcode an instance port.