photoshop-mcp · 协议与工具集成

痛点场景：当设计师遇上 AI 时代

想象这样的工作日常：产品团队需要在一天内完成 30 张社交媒体配图，每张图都要统一品牌风格——相同的字体、相近的色调、相似的版式。传统做法是设计师一张一张手工调整，机械重复；但如果把这件事交给 AI 助手呢？

问题是：AI 助手看不见 Photoshop 里的图层、选区、蒙版，它只能在文字里打转。"把背景调暗一点"、"给文字加个描边"——这类模糊指令对 AI 来说是盲人摸象。

Photoshop MCP 正是为解决这个断层而生的。它是一座桥，让 Claude、Cursor 这样的 AI 助手能够真正"看见"并操控 Photoshop——不只是生成描述文字，而是直接操作文档、图层、滤镜和选区，把"自然语言"变成"像素级操作"。

Photoshop MCP 概览

图1：Photoshop MCP — 让 AI 助手真正控制 Photoshop

项目背景：一人之力，撬动设计自动化

Photoshop MCP 由独立开发者 Ali Sait Teke（alisait.com）创建和维护，遵循 MIT 许可证，采用完全本地优先的设计——MCP 服务器、Web UI、凭证和导出文件全部留在用户本地机器上，不上传任何数据到云端。

这个项目并非 Adobe 官方产品，而是社区自发维护的创意工具。它的诞生背景值得玩味：当前 AI 编程助手（如 Cursor、Claude Desktop）已经能帮开发者写代码、读日志、做调试，但在设计领域，AI 助手始终隔着一层玻璃——看得见设计稿，但碰不到设计稿里的像素。

GitHub 上该项目已收获 193 颗星，被标注为 Adobe 官方 MCP 市场的推荐工具之一，在 MCP App Store 和 Awesome MCP Servers 列表中均有收录。值得关注的是，这是 Photoshop 相关 MCP 中唯一支持 Claude Code / Gemini CLI 免 API Key 认证的项目。

核心功能：86 个工具背后的设计哲学

原子工具层（74 个基础操作）

Photoshop MCP 暴露了 74 个原子级 MCP 工具，覆盖 Photoshop 操作的完整生命周期：

连接与信息获取

photoshop_ping — 检测 Photoshop 是否可达
photoshop_get_version — 获取 Photoshop 版本信息
photoshop_get_state — 获取当前文档完整状态（AI 决策前必查）
photoshop_get_capabilities — 获取当前环境支持的工具列表

文档管理

photoshop_create_document — 创建新文档（支持自定义分辨率、色彩模式）
photoshop_save_document — 保存为 PSD/JPEG/PNG
photoshop_close_document — 关闭文档

图层操作

photoshop_create_layer / photoshop_delete_layer — 创建/删除图层
photoshop_create_text_layer — 创建文字图层（支持字体、字号、位置）
photoshop_fill_layer — 填充纯色
photoshop_set_layer_opacity — 调整图层不透明度
photoshop_set_layer_blend_mode — 设置混合模式（Normal/Multiply/Screen/Overlay 等 20 种）
photoshop_get_layers — 获取所有图层列表

滤镜与效果

photoshop_apply_filter — 应用各类 Photoshop 滤镜
色调调整、模糊、锐化、降噪、Camera RAW 处理等

配方工具层（12 个多步复合操作）

光有原子工具还不够——一个"给照片调色"的操作背后可能涉及 10 个步骤，每步失败都让文档陷入未知状态。配方工具（Recipe Tools） 将多步骤操作封装为单一撤销单元：要么全部成功，要么一键回退，保证 AI 执行过程中的状态确定性。

生成式 AI 工具（新版 v1.1+）

支持通过生成式 AI 扩展能力，AI 可以主动发起多步骤设计操作。

Action Plan 模式（Beta）

v1.1+ 新增的 Action Plan 模式允许 AI 在单次 LLM 调用中先完整规划所有 Photoshop 步骤，再一次性执行，大幅减少来回往返次数，适合长序列操作场景。

技术架构：三层桥接设计

Photoshop MCP 的架构精髓在于三层桥接：AI 端 → MCP 服务器 → Photoshop 运行时。

AI 主机（Cursor / Claude Desktop / Web UI）
  ↓ stdio MCP
MCP 服务器（Node.js）
  ↓ AppleScript (macOS) / COM (Windows)
Adobe Photoshop ExtendScript 运行时
  ↓ HTTP 轮询 (127.0.0.1:38452)
UXP Bridge 插件（可选）

跨平台 Photoshop 检测机制值得细看：macOS 上通过 Spotlight 和 app bundle 路径自动定位，Windows 上读取注册表获取 Photoshop 安装路径。一旦找到，ExtendScript 脚本通过 AppleScript（macOS）或 COM（Windows）注入 Photoshop 执行。

架构文档（docs/architecture.md）披露了一个重要细节：整个系统是本地优先的，SQLite 数据库存储在 ~/.photoshop-mcp/ 目录下，匿名使用统计（Mixpanel/PostHog）可一键关闭。

独立 Web UI：无需 IDE 的开箱即用方案

不想在 IDE 里折腾配置？Photoshop MCP 自带完整的 Web UI：

独立 Web UI 截图

图2：独立 Web UI — 内置 AI 对话 + Photoshop 操控

Web UI 基于 Hono（轻量 Node.js 框架）+ Vue 3 前端构建，同时支持两种认证方式：

传统 API Key（OpenAI / Anthropic / Google）
Claude Code / Gemini CLI OAuth 会话复用（无需单独申请 API Key）

这意味着如果你已经在终端里用 Claude Code，这个 MCP 工具可以直接借用你的登录状态，降低了使用门槛。

部署与安装：开发者友好，但依赖 Photoshop 本体

安装流程极为简洁：

# 推荐：npx 一键运行
npx -y @alisaitteke/photoshop-mcp

# 或全局安装
npm install -g @alisaitteke/photoshop-mcp

# 启动独立 Web UI
photoshop-mcp-ui

安装完成后，在 Claude Desktop 或 Cursor 的 MCP 配置文件中添加几行 JSON 即可使用。.env 配置极为轻量，默认只需 Adobe Photoshop 本地已安装，无需额外配置。

部署限制：项目不提供 Dockerfile，不支持容器化部署。这是因为 Photoshop 是 GUI 应用，依赖 macOS 或 Windows 的图形环境，无法在 Linux 无头容器中运行。因此 quick_deploy 标记为 unsupported。

争议与局限

Photoshop 是硬依赖：没有本地安装 Photoshop，一切免谈。盗版用户需要自寻出路（ExtendScript/COM 调用本身不验证授权，但项目明确声明不鼓励盗版）。
ExtendScript 的脆弱性：文档坦言"raw ExtendScript calls are brittle"——这是项目存在的主要动机之一。配方工具层正是对这一脆弱性的工程缓解。
匿名统计默认开启：即使在 .env.example 中明确列出可关闭项，默认行为仍会上报 Mixpanel/PostHog 数据，隐私敏感用户需手动配置 ANALYTICS_DISABLED=1。
生成式 AI 调用成本：Action Plan 模式中，完整规划阶段可能触发多次 LLM 调用，长序列操作的 token 消耗需纳入成本考量。

行业意义：AI 原生设计的开路先锋

Photoshop MCP 代表的不仅是一个工具，更是一种设计自动化的新思路：当 AI 助手能够直接操控像素级工具，设计师的工作流将发生根本性转变——从"人操作工具、AI 给建议"进化到"AI 操作工具、人做决策"。

GitHub 193 星的增速、Adobe MCP 官方市场的收录、以及多个 MCP 聚合平台（mcpmarket.com、mcpapp-store.com）的主动收录，都说明社区对这类工具的需求是真实且迫切的。随着 Claude、Cursor 等 AI 编码助手向多模态演进，类似 Photoshop MCP 这样的"工具桥梁"将成为 AI Native 设计工作流的基础设施。