photoshop-mcp

Photoshop MCP

语言： 英语 · 简体中文 · Español · Deutsch · 日本語 · Türkçe · 网站

像与同事交谈一样使用 Photoshop。 用通俗的话描述你想做什么—— “移除这个背景”“将这些图片调整为 Instagram 尺寸”——你的 AI 助手 就会代你点击。支持 Cursor、Claude 或内置聊天窗口。无需代码、脚本或 IDE。

注意： 这是一个非官方、由社区维护的项目，与 Adobe Inc. 无关联，也未获其认可。

新功能：使用 Jev 即时编辑

并非每条提示词都需要语言模型。现在，内置聊天窗口可以先询问 Jev（TypeSafe AI 的 System One 模型），判断每条 消息应在任何大模型运行前发送到哪里。当 Jev 确信你请求的是 26 条安全命令和配方之一（撤销、透明度、混合模式、移除背景、色彩分级、拆分轮播图等），或像“黑白效果，然后透明度设为 50”这样的简短命令组合时，它会立即在 Photoshop 中执行：不调用大模型，也不消耗大模型令牌。其他所有请求，以及合并或拼合等难以撤销的步骤，都会交给 Action Plan。

TYPESAFE_API_KEY=... npx -p @alisaitteke/photoshop-mcp ui

此功能为实验性功能，需选择启用。不提供密钥时，界面会照常工作，不会向 TypeSafe 发送任何内容；提供密钥后，提示词也会发送到 api.typesafe.ai。有关路由、阈值和关闭开关的信息： docs/standalone-ui.md。

可以做什么？

• ✂️ 移除背景 — 将主体抠出，并生成干净、可编辑的蒙版
• 👤 修饰人像 — 磨皮、调整色调、设置加深和减淡
• 🌐 导出到网页和社交平台 — 使用 sRGB 色彩空间、锐化，并调整为适合 Instagram、X 等平台的尺寸
• 🎞️ 制作轮播图 — 将一张宽幅设计拆分为无缝衔接、带编号的幻灯片
• 💧 批量添加水印 — 一次处理整个照片文件夹，不改动原始文件
• 🎨 色彩分级及更多功能 — 胶片风格、替换天空、生成式填充（需要 Adobe 账号）
• ⏪ 放心操作 — 在 Photoshop 中，每个多步骤“配方”都是单次撤销操作

底层共有 128 个工具（111 个原子工具 + 17 个一步配方），完整列表见 docs/available-tools.md。

试着这样说

Remove the background from this portrait — keep it editable with a mask.

Enhance this portrait — smooth the skin and fix the tones, medium intensity.

Prepare this design for web, then export Instagram and X post variants.

Split this wide banner into a 5-slide seamless Instagram carousel.

更多配方（批量添加水印、证件照、由 CSV 驱动的卡片、样机等）以及预先设计的提示词模板：docs/prompt-layer.md。

开始使用

你需要运行中的 Photoshop（Windows 或 macOS，2012 年及之后的任意版本）和 Node.js 18+。

选项 1 — 最简单：内置聊天窗口

npx -p @alisaitteke/photoshop-mcp ui

聊天窗口会在浏览器中打开。使用 AI 提供商的 API 密钥登录，或者复用现有的 Claude Code / Gemini CLI 账号，无需密钥。

详情、提供商、操作计划（API 密钥或 CLI 账号）和安全说明： docs/standalone-ui.md。

选项 2 — 在你的 AI 应用中使用（Cursor、Claude、VS Code）

Cursor（会在 MCP 列表中显示 Photoshop 徽标）： 从 Customize → Plugins 安装插件，或在插件上架后，在 Cursor Marketplace 中搜索 photoshop-mcp。该软件包仍会启动 npx -y @alisaitteke/photoshop-mcp；图标由插件清单提供。

在 Marketplace 上架之前，请将 .cursor-plugin/、mcp.json 和 assets/ 复制到 ~/.cursor/plugins/local/photoshop-mcp 并重新加载窗口 — 详情见 CONTRIBUTING.md。在 Cursor 中安装按钮和原始 mcp.json 条目仍然可用，但会显示通用图标。

Claude Code：

claude mcp add photoshop -- npx -y @alisaitteke/photoshop-mcp

或者，将以下内容添加到你的 MCP 客户端配置中（Cursor、Claude Desktop 等）：

{
  "mcpServers": {
    "photoshop": {
      "command": "npx",
      "args": ["-y", "@alisaitteke/photoshop-mcp"]
    }
  }
}

工作原理

1. 你输入想要完成的操作，用自然语言描述即可。
2. AI 规划操作步骤，并先检查文档状态。
3. Photoshop 执行操作 — 每个配方都会作为一个可撤销的步骤应用。

遇到问题？AI 会读取结构化错误信息，并知道接下来该尝试什么。常见解决方法：docs/troubleshooting.md。

文档

• 可用工具 — 全部 128 个工具及其参数
• 独立界面 — 提供商、身份验证模式、操作计划、安全性
• 提示词层 — 提示词模板和配方
• 架构 — 桥接层的底层工作原理
• 开发 — 从源代码构建、测试

参与贡献

欢迎贡献！提交 PR 前，请先阅读 CONTRIBUTING.md。

❤️ 贡献者与致谢

感谢所有贡献者！

维护者

由 Ali Sait Teke 构建 — GitHub · LinkedIn。

许可证

MIT

默认会收集匿名汇总使用情况分析数据，可随时禁用 — 详情请见 docs/anonymous-usage-analytics.md。