跳到主要内容
Beta3D & Animation

MCP for Maya — Connect AI Agents to Maya

Maya 场景首先是图结构、引用和命名空间，其次才是形状。Agent 针对这套结构工作——解析名称、尊重引用，绝不去猜自己刚刚重连了哪个节点。

Install Maya integrationComing soon
Read-only by default10 typed toolsCheckpointed writes
Technical specification
宿主软件
Maya 2024, 2025 and 2026
运行时
Python 3.10+ (mayapy) and the Maya Python API 2.0
传输方式
stdio (local) and streamable HTTP (studio)
安装方式
Maya module (mod) + npx dccmcp-maya
运行模式
Interactive session, mayapy standalone, render-farm workers
支持平台
Windows, macOS, Linux
Last reviewed
2026-09-20
概述

什么是 MCP for Maya？

MCP for Maya is a local MCP server plus a Maya plugin that connects AI agents to a real Maya session. Agents discover 10 typed tools — including scene.inspect, namespace.resolve, node.create and node.connect — and call them to inspect, create, modify and validate work inside the live application.

Unlike generated Maya scripts, every call is validated against your current document, classified as read, write or execute, and recorded in an audit log. Maya stays open, the document stays live, and destructive operations are checkpointed so they can be rolled back.

It works with Claude Code, Codex, Cursor, GitHub Copilot, Claude Desktop, Gemini CLI, Trae, Doubao, Qwen Code, CodeBuddy, Custom MCP clients over stdio or streamable HTTP.

  • 宿主软件: Maya 2024, 2025 and 2026
  • 运行时: Python 3.10+ (mayapy) and the Maya Python API 2.0
  • 传输方式: stdio (local) and streamable HTTP (studio)
为什么会失败

没有契约时，让 Agent 驱动 Maya 会出什么问题

01

命名空间会悄悄让所有硬编码名称失效

在美术的会话里能跑的脚本，到了镜头文件就报错——因为引用进来变成了 props_v003:pCube1。Agent 必须先解析名称，而不是等到报错。

02

一次错误的图连线就毁掉绑定

重连一条 DG 连接、覆盖一个驱动关键帧，会悄悄破坏花了整整一周做出来的绑定，而问题往往在下一轮动画才暴露。

03

重场景经不起试探性自动化

为了回答一个问题就打开、求值、重建整个场景的 Agent，在生产镜头上根本没法用。读取必须是有范围、低成本的。

如何工作

MCP for Maya 如何保住设计意图、结构与可追溯性

一个 MCP Server 加一个 Maya 模块，让 Agent 以类型化方式访问场景图、DG 连线、引用与命名空间、动画曲线，以及 mayapy 无界面批处理。

感知命名空间的解析

工具接受短名或全名，并对照实时命名空间树解析，返回实际命中路径，让 Agent 清楚自己动的是哪个节点。

改动前先给差异

连线与属性改动会先以 diff 形式返回再应用，且每次写入都运行在带检查点的事务里。

安全引用组装

Agent 可以查看引用及其版本、主动切换版本；除非策略允许，否则无法编辑被引用内容。

mayapy 批处理一致

同一套工具面可在 mayapy 独立模式运行， Agent 无需打开界面就能把一个修改应用到整个镜头列表。

工具参考

MCP for Maya 工具清单与风险等级

Agent 在连接时就能发现这份清单。你可以决定哪些自动放行、哪些需要人工确认、哪些在生产文件中直接禁用。

工具名与参数签名保持英文——它们是 Agent 实际调用的接口。

  • scene.inspectScoped snapshot of the DAG, namespaces, references, layers and render settings.read
  • namespace.resolveResolve short, ambiguous or wildcard names against the live namespace tree.read
  • node.createCreate DAG or DG nodes with validated parenting and attribute presets.write
  • node.connectWire and rewire dependency graph connections with a returned diff.write
  • attribute.setSet transform or custom attributes, including driven-key keys.write
  • reference.manageList, load, unload and version-swap references without touching referenced edits.write
  • animation.keyframeRead and write keyframes and tangents across selected channels.write
  • curve.editEdit animation curves: scale, offset, retime and bake with explicit ranges.write
  • render.submitSubmit renders with declared camera, range and renderer settings.execute
  • scene.checkpointCreate, list and restore named scene checkpoints.write
安装

四步安装 MCP for Maya

全部本地运行。服务默认只绑定回环地址，且只暴露你在 Maya 中批准的工具。

预发布。 以下命令描述的是我们即将发布的接口，软件包尚未发布。 Get notified when MCP for Maya launches.

STEP 01

安装 Maya 模块

把 DCCMCP 模块放进 Maya 的 module 路径。支持按项目配置模块目录，适合把工具链放在流水线仓库里的团队。

cp -R dccmcp-maya/ /usr/local/maya/modules/
STEP 02

启动桥接服务

对已打开的会话运行桥接，或让它启动 mayapy 做批处理。

npx dccmcp-maya@latest serve --session active
STEP 03

注册客户端

把服务注册到 Claude Code、Codex、Cursor、OpenClaw 或任何其他 MCP 客户端。工作室构建也可以指向共享的 HTTP 传输。

{
  "mcpServers": {
    "maya": { "command": "npx", "args": ["dccmcp-maya", "serve"] }
  }
}
STEP 04

保护被引用内容

默认禁止写入被引用节点，避免 Agent 悄悄修改共享资产。

dccmcp policy deny --tool node.create --when referenced=true

MCP for Maya works with the agents you already use

  • Claude Code
  • Codex
  • Cursor
  • GitHub Copilot
  • Claude Desktop
  • Gemini CLI
  • Trae
  • Doubao
  • Qwen Code
  • CodeBuddy
  • Custom MCP clients

Any other MCP-compatible client works too — one config entry, stdio by default.

Read the docs
其他集成

常与 Maya 搭配使用的其他 MCP 集成

MCP for Blender

Connect AI agents to Blender — scene graph, geometry nodes, renders and batch automation.

查看集成

MCP for 3ds Max

Archviz and animation automation for agents — modifiers, materials, XRefs and batch export.

查看集成

MCP for Rhino

Drive Rhino and Grasshopper from an AI agent — NURBS, layers, blocks and parametric definitions.

查看集成

10 integrations available

Compare tool lists, support matrices and policies for every supported application.

Browse all integrations
常见问题

团队在安装前最常问的问题

如果没有覆盖到你的问题，直接写信给我们——技术问题我们给技术回答。

  • Beta 通道支持 Maya 2024、2025 与 2026，使用 Python 3 与 Maya Python API 2.0。Python 2 / Maya 2022 及更早版本仅对企业客户开放。

  • 图连线与属性写入都有检查点，并以 diff 形式返回；被引用内容默认只读；策略可以直接禁用特定节点类型——例如绑定控制组下的任何节点。

  • 可以。同一套工具在 mayapy 独立模式下同样暴露，多数团队就是用它在整个镜头列表上应用已批准的修改，或提交给渲染农场。

  • 引用是一等公民：Agent 可以查看、核对版本并有意识地切换。USD Stage 可读取，并在策略批准的前提下通过 Maya 的 USD 集成进行编辑。

  • 渲染提交与渲染器无关——Agent 声明渲染器与设置，服务会对照你会话中实际安装的内容做校验。Arnold、V-Ray、RenderMan 都在我们的测试语料里。

npx dccmcp-blender@latest serve

Put an agent inside your real tools — without putting your pipeline at risk

Install an integration, set a policy, and let your agent inspect, build and validate work in Blender, Maya, Houdini, 3ds Max, Rhino, ZBrush, Photoshop, FreeCAD, QGIS or OpenCV. Free to start, local by default.

Coming soonRead the quickstart

macOS · Windows · Linux — no cloud dependency required