跳到主要内容
文档

四条命令装好,然后决定 Agent 能碰什么

这份文档覆盖安装、客户端配置、策略模型与审计格式。每个集成的工具清单在各自的产品页上——本页是它们共同依赖的那一层。

快速上手

尚未发布。本页命令描述的是我们即将交付的接口。目前 npm 与 PyPI 上都还没有发布任何包——留下邮箱,发布时通知你

选一个集成,装好原生插件,启动 MCP Server,再注册到你的客户端。下面以 Blender 为例,其他软件的形态完全一致。

1 — 安装宿主插件
blender --command extension install dccmcp_blender
2 — 启动 MCP Server
npx dccmcp-blender@latest serve --port 7331
3 — 注册到你的 Agent
{
  "mcpServers": {
    "blender": {
      "command": "npx",
      "args": ["dccmcp-blender", "serve"]
    }
  }
}
4 — 用一次只读调用验证
dccmcp doctor --tool scene.inspect

默认策略是只读。写工具在你批准之前一直处于封锁状态,所以第一次会话可以放心地只做探查。

安装矩阵

软件插件 / 包Server
Blenderblender --command extension install dccmcp_blendernpx dccmcp-blender serve
Maya在 MAYA_MODULE_PATH 放置 Maya module (mod)npx dccmcp-maya serve
Houdini在 HOUDINI_PACKAGE_PATH 放置 Houdini packagenpx dccmcp-houdini serve
3ds Max3dsmaxbatch -U dccmcp-3dsmax.mzpnpx dccmcp-3dsmax serve
Rhinoyak install dccmcp-rhinonpx dccmcp-rhino serve
ZBrush把 ZScript 放进 ZStartup 目录npx dccmcp-zbrush serve
Photoshopuxp install ./dccmcp-photoshop.ccxnpx dccmcp-photoshop serve
FreeCAD插件管理器 → DCCMCP Workbenchnpx dccmcp-freecad serve
QGIS插件 → 管理与安装插件 → DCCMCPnpx dccmcp-qgis serve
OpenCVpip install dccmcp-opencvdccmcp-opencv serve

Agent 客户端

所有 Server 都通过 stdio 与可流式 HTTP 讲 Model Context Protocol,所以你已经在用的客户端可以继续用。下面是我们在每个版本都会测试的客户端;不在列表里但支持 MCP 的 Agent 同样可用。

  • Claude CodeAnthropic
  • CursorAnysphere
  • CodexOpenAI
  • GitHub CopilotGitHub
  • Claude DesktopAnthropic
  • Gemini CLIGoogle
  • WindsurfCognition
  • ClineOpen source
  • Roo CodeOpen source
  • TraeByteDance
  • DoubaoByteDance
  • Qwen CodeAlibaba
  • KimiMoonshot AI
  • Zhipu GLMZhipu AI
  • CodeBuddyTencent
  • YuanbaoTencent
  • LingmaAlibaba
  • QoderAlibaba
  • ContinueOpen source
  • ZedZed Industries
  • JetBrains AIJetBrains
  • GooseBlock
  • WarpWarp
  • CozeByteDance
  • CodeGeeXZhipu AI
  • ComateBaidu
  • ERNIEBaidu
  • SparkiFlytek
  • MiniMax AgentMiniMax
  • OpenClawOpen source
  • WorkBuddyIndependent
  • Your own agentMCP SDK
stdio —— 本地使用,每个 Server 一条配置
{
  "mcpServers": {
    "blender": { "command": "npx", "args": ["dccmcp-blender", "serve"] }
  }
}
可流式 HTTP —— 工作室共享部署
{
  "mcpServers": {
    "blender": {
      "type": "http",
      "url": "http://studio-host:7331/mcp",
      "headers": { "Authorization": "Bearer <token>" }
    }
  }
}

只能用命令加参数(而不接受 URL)的客户端走 stdio 配置项;运行在另一台机器上的客户端走 HTTP 配置项,除非你显式放开,它默认只绑定回环地址。

工具参考

每个 Server 在连接时发布自己的工具清单。完整清单、参数与风险等级按集成分别记录。

策略与审批

策略决定一次工具调用会发生什么:直接执行、请求人工确认,或者拒绝。策略是声明式文件,因此可以被评审、纳入版本管理,并在团队内共享。

policy.toml
[default]
mode = "read-only"

[[rule]]
tool = "object.create"
action = "require-approval"

[[rule]]
tool = "pipeline.checkpoint.restore"
action = "deny"
when = { path = "**/production/**" }

[[rule]]
tool = "scene.inspect"
action = "allow"
audit = "summary"

审批可以是交互式的——Agent 暂停,由人在客户端里确认;也可以是异步的——请求进入审核队列,Agent 先去处理别的工作。

审计与回滚

每一次调用都会写入一条结构化记录。记录在磁盘上只追加,并可流式推送到 Webhook 或 SIEM。

审计条目
2026-09-20T09:14:22Z  studio/leon
tool      geometry_nodes.set_input
args      { "socket": "Inset", "value": 0.02 }
result    ok · 118 ms · 3 variants
file      facade_module_01.blend @ sha256:9f2c…
host      Blender 4.5.1
回滚
dccmcp restore --checkpoint facade-a1.ckpt --scope objects

Skills SDK

当工作室的约定需要固化时,注册你自己的工具。一个 skill 就是「类型化可调用对象 + 清单文件」,它继承与内置工具完全相同的策略和审计行为。

skills/rename_by_convention.py
from dccmcp import tool, Skill

skill = Skill(
    name="studio-naming",
    tools=[
        tool(
            name="naming.rename_collection",
            risk="write",
            schema={"collection": "str", "pattern": "str"},
        )(rename_collection),
    ],
)

更新日志

  • v1.4.02026-09-08
    • 新增可流式 HTTP 传输,支持局域网部署的 Token 鉴权。
    • Blender:几何节点模拟区现在可以通过 socket 路径寻址。
    • QGIS:处理过程的溯源记录现在会带上算法提供方与版本。
  • v1.3.22026-08-19
    • Rhino:图块实例变换支持旋转约束。
    • 修复了两个会话写入同一文件时的检查点命名冲突。
  • v1.3.02026-08-02
    • Skills SDK 1.0 —— 可用 Python 或 .NET 注册自定义类型化工具。
    • 审计条目现在会记录宿主应用版本指纹。

状态与支持矩阵

软件支持的版本适配节奏
Blender4.2 LTS · 4.5 LTS · 5.x厂商发布后 14 天内完成测试
Maya2024 · 2025 · 2026厂商发布后 14 天内完成测试
Houdini20.5 · 21+稳定版发布后 21 天内完成测试
3ds Max2024 · 2025 · 2026厂商发布后 14 天内完成测试
RhinoRhino 7 · 8 · 9 WIP 分支厂商发布后 14 天内完成测试
ZBrush2024 · 2025+(桌面版)稳定版发布后 30 天内完成测试
Photoshop2024 · 2025 · 2026厂商发布后 14 天内完成测试
FreeCAD0.21 · 1.0+稳定版发布后 21 天内完成测试
QGIS3.34 LTR · 3.40+LTR 发布后 14 天内完成测试
OpenCV4.x · 5.x持续跟进

要给团队部署?

我们可以为你的 IT 或安全团队讲解传输方式、存储与策略导出。

联系我们

想看安全姿态?读一下安全概览(英文)。