substance 3d painter mcp
substance 3d painter mcp 指的是 Substance 3D Painter 的 MCP(Model Context Protocol)支持,它让外部 AI 工具(如 Claude、Cursor)能直接读取当前项目、图层、材质和纹理信息,并辅助生成脚本或操作建议;目前官方并未内置 MCP 服务器,通常需要借助社区插件或自建桥接程序来实现。
- 理解 MCP 在 Substance 3D Painter 中的角色
MCP 是一种标准化协议,用于让 AI 助手与软件交换上下文。在 Substance 3D Painter 中,MCP 服务器可以暴露项目的节点树、图层属性、贴图通道、资源路径等数据,使 AI 能理解你正在绘制的模型、当前使用的智能材质、遮罩和层级关系。它本身不是官方功能,而是通过外部进程与软件通信,因此你需要先确认自己的需求:是想让 AI 帮你写 Python 脚本、自动生成材质,还是辅助排查图层问题。 - 检查当前版本是否支持 MCP 或需要插件
打开 Substance 3D Painter,进入「帮助」菜单下的「关于」,查看版本号。官方在较新版本中可能加入了 MCP 相关实验性功能,但多数情况下需要安装第三方插件(例如社区开发的 MCP bridge)。你可以在软件的插件市场(Plugin Store)搜索「MCP」,如果没有结果,则说明当前版本未集成,需前往官方论坛或 GitHub 搜索社区方案。安装插件后,通常需要在软件内启用「开发者模式」或「脚本运行」权限。 - 配置 MCP 服务器连接
以常见的社区实现为例,你需要先启动一个本地 MCP 服务器(通常用 Python 或 Node.js 编写),然后在 AI 客户端(如 Claude Desktop、Cursor)的配置文件中添加该服务器的地址(例如 http://127.0.0.1:8080/mcp)。在 Substance 3D Painter 中,通过「编辑」>「首选项」>「脚本」或「插件」选项卡,找到 MCP 插件的设置项,填入端口和认证令牌(若有)。注意:不同插件的配置界面不同,请以插件文档为准。 - 通过 MCP 让 AI 读取项目数据
连接成功后,你可以在 AI 对话框中输入如「读取当前项目的图层列表」或「告诉我这个材质的属性」,AI 会通过 MCP 工具调用获取实时数据。例如,你正在绘制一个木箱,AI 可以读取到当前有「Base Color」「Roughness」「Height」通道,以及一个名为「Wood_Planks」的智能材质。基于这些信息,AI 能建议你调整图层混合模式、添加蒙版或生成修复脚本。注意:MCP 只能读取软件暴露的数据,无法直接操作 UI,所有修改仍需通过脚本或手动完成。 - 常见问题与排查思路
如果连接失败,先检查 MCP 服务器是否启动、端口是否被占用,以及 Substance 3D Painter 的插件是否加载成功(查看「插件」面板是否有错误日志)。其次,确认 AI 客户端配置的地址与插件设置一致。若 AI 无法读取数据,可能是插件权限不足,尝试以管理员身份运行软件(仅限 Windows)。另外,某些 MCP 实现需要项目保存后才能同步最新状态,记得先保存文件。如果问题依旧,到插件 GitHub 仓库的 Issues 区搜索类似错误。
软件页面:Substance 3D Painter。