跳到主要内容
Beta2D & Texture

MCP for Photoshop — Connect AI Agents to Photoshop

贴图工作首先是命名和色彩管理问题，其次才是视觉问题。Agent 拿到的是能保持图层栈可编辑、导出引擎真正认得的贴图的工具。

Install Photoshop integrationComing soon
Read-only by default9 typed toolsCheckpointed writes
Technical specification
宿主软件
Photoshop 2024, 2025 and 2026
运行时
UXP plugin (JavaScript) with an ExtendScript fallback for legacy actions
传输方式
stdio (local) and streamable HTTP (studio)
安装方式
UXP plugin + npx dccmcp-photoshop
支持文档
PSD, PSB, TIFF, PNG, JPEG, EXR (via host support)
支持平台
Windows, macOS
Last reviewed
2026-09-14
概述

什么是 MCP for Photoshop？

MCP for Photoshop is a local MCP server plus a Photoshop plugin that connects AI agents to a real Photoshop session. Agents discover 9 typed tools — including document.inspect, layer.create, layer.effects and mask.create — and call them to inspect, create, modify and validate work inside the live application.

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

  • 宿主软件: Photoshop 2024, 2025 and 2026
  • 运行时: UXP plugin (JavaScript) with an ExtendScript fallback for legacy actions
  • 传输方式: stdio (local) and streamable HTTP (studio)
为什么会失败

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

01

自动化把本该加速的文件压平了

为了导出一张 PNG 而合并图层的批处理脚本，毁掉了源 PSD 的可编辑性。美术要为这次自动化付好几个月的时间。

02

贴图以错误的色彩空间到达

法线与粗糙度贴图不能被 sRGB 编码，但忽略文档配置文件的导出会产出在引擎里悄悄破坏光照的贴图。

03

命名规范就是整条流水线

一个叫 final_v2_NORMAL_fixed.png 的贴图会直接打断导入。引擎要的是确定的后缀、一致的尺寸与可预期的通道打包。

如何工作

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

一个 MCP Server 加一个 Photoshop UXP 插件，把文档、图层、蒙版、调整栈、通道与配置文件状态、批量导出暴露为类型化工具，服务于贴图与市场物料流水线。

默认非破坏性

编辑以图层、蒙版与调整图层的形式落地。合并、压平与破坏性滤镜需要策略显式批准。

色彩管理导出

Agent 按贴图类型声明目标色彩空间，服务在写文件前校验文档配置文件与位深。

令牌化贴图集

用命名模板与统一分辨率导出完整 PBR 集——基础色、法线、粗糙度、金属度、AO、高度——并写出清单。

带检查点的文档

修改型操作前会写出版本化检查点，因此一次坏批量可以按文档回滚，而不是按文件夹。

工具参考

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

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

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

  • document.inspectSize, resolution, color mode, profile, bit depth and layer tree.read
  • layer.createCreate pixel, fill, shape, text, group or adjustment layers in place.write
  • layer.effectsApply layer styles, blend modes, opacity and clipping relationships.write
  • mask.createBuild layer and vector masks from selections, channels or alpha sources.write
  • selection.modifyGrow, feather, invert, refine and save selections into channels.write
  • adjustment.applyApply non-destructive adjustment layers with validated parameters.write
  • batch.actionRun approved actions across a document set with per-file result reporting.execute
  • texture.export_setExport a tokenized PBR map set with color-space validation and a manifest.execute
  • asset.exportExport flattened or layered output at declared sizes and formats.execute
安装

四步安装 MCP for Photoshop

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

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

STEP 01

安装 UXP 插件

通过 UXP Developer Tool 安装 DCCMCP 插件，或用工作室的扩展下发机制部署。

uxp install ./dccmcp-photoshop.ccx
STEP 02

启动桥接服务

桥接把 MCP 客户端连到正在运行的 Photoshop 实例及其打开的文档。

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

注册客户端

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

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

声明贴图规范

告诉服务你的引擎期望哪些后缀与色彩空间，导出时会据此校验。

dccmcp texture set --template "{name}_{map}_{res}.png" --linear normal,roughness,metallic,ao,height

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

常与 Photoshop 搭配使用的其他 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
常见问题

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

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

  • 不会。该集成不调用 Firefly 或任何生成式功能，只暴露文档、图层、蒙版、色彩管理与导出操作，你的文件不会经由我们送到生成式模型。

  • 除非策略允许，否则不会。编辑以图层、蒙版与调整图层完成，压平与合并等破坏性操作默认被禁止。

  • Photoshop 2024、2025 与 2026，使用 UXP 插件架构。旧的 ExtendScript 动作仍可通过批量工具运行以保持兼容。

  • 可以。贴图导出工具按你的命名模板写出完整贴图集，按贴图类型校验线性与色彩数据，并产出列出每个文件与分辨率的清单。

  • 没有。DCCMCP 是独立的第三方集成，与 Adobe 无隶属、背书或赞助关系。

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