跳到主要内容
PreviewSculpting & Texturing

MCP for ZBrush — Connect AI Agents to ZBrush

雕刻文件会长成几百个子工具、面数不可预期。Agent 拿到的是诚实的清单和明确的分辨率目标，让重网格成为一个决定而不是一次赌博。

Install ZBrush integrationComing soon
Read-only by default10 typed toolsCheckpointed writes
Technical specification
宿主软件
ZBrush 2024, 2025 and newer (desktop)
运行时
ZScript bridge with a companion process for mesh statistics and baking
传输方式
stdio (local) and streamable HTTP (studio)
安装方式
ZStartup script + npx dccmcp-zbrush
交换格式
GoZ handoff to Maya, Blender, 3ds Max and ZBrush plugins
支持平台
Windows, macOS
Last reviewed
2026-09-10
概述

什么是 MCP for ZBrush？

MCP for ZBrush is a local MCP server plus a ZBrush plugin that connects AI agents to a real ZBrush session. Agents discover 10 typed tools — including tool.inspect, subtool.create, subtool.folder and dynamesh.remesh — and call them to inspect, create, modify and validate work inside the live application.

Unlike generated ZBrush scripts, every call is validated against your current document, classified as read, write or execute, and recorded in an audit log. ZBrush 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.

  • 宿主软件: ZBrush 2024, 2025 and newer (desktop)
  • 运行时: ZScript bridge with a companion process for mesh statistics and baking
  • 传输方式: stdio (local) and streamable HTTP (studio)
为什么会失败

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

01

子工具泛滥让文件失控

一个有一百八十个子工具、命名毫无纪律的角色文件就是生产风险。没人知道哪个子工具是当前版本、为什么这么命名、到底有多重。

02

重网格的决定不可逆且昂贵

ZRemesher 目标面数与 DynaMesh 分辨率会永久改变拓扑。数字填错，就意味着重做数小时的雕刻细节。

03

顶点色永远到不了引擎

细节一直活在顶点色里，直到有人把它烘焙成贴图——而分辨率选错就要再烘焙一轮。

如何工作

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

面向 ZBrush 的 MCP Server 与 ZScript 桥接，把子工具清单、重网格与减面、多边形组操作、顶点色烘焙与 GoZ 交接暴露为类型化工具。

先看清子工具

Agent 在提出任何操作前，先读取每个子工具的面数、可见性、文件夹与材质，命名与面数问题立刻暴露。

显式分辨率目标

重网格与减面必须给出明确目标——面数或边长——工具会返回实际结果，让改动是被测量的而不是被假设的。

感知多边形组

拆分、合并、分组与可见性操作都作用于具名多边形组，让硬表面与软表面部件可分离。

GoZ 交接

把选中的子工具按声明的细分级别送到 Maya、Blender 或 3ds Max，往返过程记录在审计日志里。

工具参考

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

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

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

  • tool.inspectActive tool, subtool list, polycounts, visibility, folders and materials.read
  • subtool.createDuplicate, split, append or delete subtools with explicit targets.write
  • subtool.folderOrganize subtools into named folders and set visibility states.write
  • dynamesh.remeshRun DynaMesh at a declared resolution and return the resulting polycount.write
  • zremesher.retopoRetopologize to a target count or edge length with symmetry settings.write
  • decimate.ratioDecimate to a declared polygon budget for export or baking.write
  • polygroup.manageCreate, expand and split polygroups for hard-surface separation.write
  • uv.unwrapRun UV Master unwrapping with island and resolution parameters.write
  • texture.bakeBake polypaint and sculpted detail to texture maps at a declared size.execute
  • goz.sendHand off a subtool to another application at a declared subdivision level.execute
安装

四步安装 MCP for ZBrush

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

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

STEP 01

安装 ZStartup 脚本

把 DCCMCP 脚本放进 ZBrush 的 ZStartup 目录，桥接会随应用一起加载。

cp dccmcp_zbrush.txt "$ZBRUSH/ZStartup/"
STEP 02

启动桥接服务

桥接负责协调 ZScript 命令与配套进程，后者计算网格统计并执行烘焙。

npx dccmcp-zbrush@latest serve --companion
STEP 03

注册客户端

把服务注册到 Claude Code、Codex、Cursor、OpenClaw 或任何其他 MCP 客户端。

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

设置面数上限

限制 Agent 可以请求的面数预算，避免一次重拓扑把子工具推到下游工具打不开的程度。

dccmcp policy limits --max-polygons 8000000

MCP for ZBrush 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
其他集成

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

MCP for Blender

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

查看集成

MCP for Rhino

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

查看集成

MCP for FreeCAD

Parametric CAD automation for agents — sketches, features, tech drawings and STEP exports.

查看集成

10 integrations available

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

Browse all integrations
常见问题

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

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

  • 目前处于 Preview 通道。读取子工具结构、按目标重网格、减面与 GoZ 交接在我们的测试语料中已经稳定。贴图烘焙较新，建议先用自己的材质设置验证再依赖它。

  • ZBrush 的脚本接口并未暴露 Agent 需要的全部信息，尤其是操作后的准确统计与烘焙结果。本地配套进程负责计算这些并回报，从而保证工具结果可信。

  • 不支持。该集成针对桌面版。ZBrush for iPad 没有暴露这个桥接所依赖的脚本接口。

  • 重网格必须给出明确目标，作为带检查点的操作运行，并且策略可以按工具或文件直接禁用。宿主允许时，回滚可以限定在单个子工具。

  • GoZ 交接覆盖 Maya、Blender、3ds Max 以及任何装了 GoZ 桥接的应用，细分级别由 Agent 声明。

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