用途:这是一个操作者(operator)技能,用于让智能体把一台机器准备好,使任意 MCP 主机都能配合 Autodesk Maya 使用 dcc-mcp-maya。它不是 Maya 运行时技能,不应通过 Maya MCP 服务器加载,应从仓库检出目录运行,或把其步骤复制到其他智能体的指令中
主要能力:从仓库根目录可运行 python skills/dcc-mcp-maya-setup/scripts/setup_dcc_mcp_maya.py。脚本会从 --mayapy、MAYAPY、DCC_MCP_MAYA_MAYAPY、PATH 或常见 Autodesk 安装位置查找 mayapy;以 sidecar extra 安装当前检出:mayapy -m pip install -e ".[sidecar]";验证适配器导入,并要求 Core 版本满足 dcc-mcp-core>=0.19.45,<1.0.0;在 .dcc-mcp/agent-setup/ 下写出可复用的 MCP JSON 片段。面向终端用户机器时可用 --source pypi 改为从 PyPI 安装。若自动发现失败,可指定路径,例如 --mayapy "C:\Program Files\Autodesk\Maya2025\bin\mayapy.exe"
使用方式:默认推荐插件 sidecar 模式,在 MCP 主机中配置 {"mcpServers":{"maya":{"url":"http://127.0.0.1:9765/mcp"}}}。如需显式直连,先运行 dcc-mcp-cli list 并使用其中发布的确切实例 URL,不要硬编码端口。编辑现有 MCP 配置时保留无关服务器,仅合并 maya 条目。安装与生成配置后,引导用户打开 Maya,进入 Window > Settings/Preferences > Plug-in Manager,添加或找到 dcc_mcp_maya_plugin.py,勾选 Loaded(可选 Auto load),并在 Script Editor 中查看 MCP URL。验证时让 MCP 主机先调用 dcc_capability_manifest(loaded_only=false),再加载 maya-primitives,创建半径 2、名为 mcp_setup_smoke_sphere 的球体,列出场景对象并回报 MCP URL 与对象名;优先使用类型化工具,避免 execute_python
限制与排障:mayapy 未找到需向用户询问确切 Maya 版本与路径;pip 引导失败可运行 mayapy -m ensurepip --upgrade 后重试;连接被拒通常是 Maya 未运行、插件未加载或主机缓存了过期直连 URL;工具缺失可调用 dcc_capability_manifest 或 search_skills 后 load_skill("<skill-name>");插件加载后卡住需检查 Script Editor 输出、防火墙/localhost 规则及阻塞性 Maya 对话框。其他收费、平台与效果信息暂未提供。