adb-mcp

adb-mcp 是一个概念验证项目，旨在通过 MCP 协议为大型语言模型（LLM）提供接口，从而实现人工智能对 Adobe 工具（Adobe Photoshop 和 Adobe Premiere）的控制。

该项目并未获得 Adobe 的认可或支持。

它已在 Anthropic 的 Claude 桌面版（Mac 和 Windows）以及 OpenAI Agent SDK 上进行了测试，允许 AI 客户端控制 Adobe Photoshop 和 Adobe Premiere。理论上，只要支持 MCP 协议的任何 AI 应用程序或 LLM 都可以使用该工具，并且其架构设计能够兼容多种 Adobe 应用程序。

示例用法包括：

• 向 Claude 提供在 Photoshop 中逐步操作的指令，构建一个基于对话式的界面（尤其适合初学者）。
• 向 Claude 下达任务（例如创建一张类似宝丽来照片的 Instagram 帖子、制作双重曝光效果），并让其从头到尾完成，作为模板使用。
• 请求 Claude 为你生成定制化的 Photoshop 教程，先创建一个示例文件，再提供逐步骤的操作说明。
• 将 Claude 用作 Photoshop 的实用工具（例如让 Claude 将所有图层重命名为统一格式）。
• 让 Claude 创建新的 Premiere 项目，并预先填充片段、转场、特效和音频。

观看视频示例

由于当前 Premiere 插件 API 的限制，Premiere 代理的功能相比 Photoshop 代理稍显有限。

工作原理

该概念验证项目通过以下方式实现：

• 一个 MCP 服务器，为 AI 或 LLM 提供访问 Adobe Photoshop 功能的接口。
• 一个基于 Node.js 的命令代理服务器，位于 MCP 服务器与 Adobe 应用程序插件之间。
• 一个 Adobe 应用程序（Photoshop 和 Premiere）插件，用于监听命令并驱动软件运行。

AI <-> MCP 服务器 <-> 命令代理服务器 <-> Photoshop / Premiere UXP 插件 <-> Photoshop / Premiere

之所以需要代理服务器，是因为基于 UXP 的 JavaScript 插件公开 API 不支持以服务器模式监听套接字连接，因此无法让 MCP 服务器直接与其建立连接（它只能作为客户端连接到套接字）。

系统要求

要运行此项目，需满足以下条件：

• 支持 MCP 协议的 AI LLM（已测试过 Mac 和 Windows 上的 Claude 桌面版，以及 OpenAI Agent SDK）。
• Python 3，用于运行本项目提供的 MCP 服务器。
• Node.js，用于搭建 MCP 服务器与 Photoshop 之间的代理。
• Adobe UXP 开发者工具（可通过 Creative Cloud 获取），用于安装和调试连接代理的 Photoshop / Premiere 插件。
• Adobe Photoshop（26.0 或更高版本），并已安装 MCP 插件；或 Adobe Premiere Beta（25.3 Build 46 或更高版本）。

安装步骤

本指南假设您使用的是 Claude 桌面版。其他兼容 MCP 协议的 AI 应用程序应遵循类似的安装流程。

下载源代码

从 主项目页面 克隆或下载源代码。

安装 Claude 桌面版

1. 下载并安装 Claude 桌面版。
2. 启动 Claude 桌面版，确认其正常运行。

注意：您可以使用任何支持 MCP 协议的客户端或代码，只需按照其配置说明进行操作即可。

安装用于开发的 MCP 工具

进入项目目录并执行以下命令：

Photoshop

uv run mcp install --with fonttools --with python-socketio --with mcp --with requests --with websocket-client --with numpy ps-mcp.py

Premiere Pro

uv run mcp install --with fonttools --with python-socketio --with mcp --with requests --with websocket-client --with pillow pr-mcp.py

InDesign

uv run mcp install --with fonttools --with python-socketio --with mcp --with requests --with websocket-client --with pillow id-mcp.py

AfterEffects

uv run mcp install --with fonttools --with python-socketio --with mcp --with requests --with websocket-client --with pillow ae-mcp.py

Illustrator

uv run mcp install --with fonttools --with python-socketio --with mcp --with requests --with websocket-client --with pillow ai-mcp.py

安装完成后，请重启 Claude 桌面版。

设置代理服务器

使用预编译的可执行文件（推荐）

1. 从最新发布的 release 页面 下载适用于您平台的可执行文件（文件名如 adb-proxy-socket-macos-x64.zip（Intel）、adb-proxy-socket-macos-arm64.zip（Silicon）或 adb-proxy-socket-win-x64.exe.zip）。
2. 解压可执行文件。
3. 双击运行，或在控制台/终端中执行。

从源码运行

1. 进入 adb-proxy-socket 目录。
2. 执行 node proxy.js。

您应该会看到类似以下的消息： Photoshop MCP 命令代理服务器正在 ws://localhost:3001 上运行

请保持此进程运行——代理服务器必须持续运行，才能使 Claude 与 Adobe 插件进行通信。

安装插件

Photoshop、Premiere Pro、InDesign（UXP）

1. 从 Creative Cloud 启动 UXP 开发者工具
2. 在提示时启用开发者模式
3. 选择 文件 > 添加插件
4. 导航到相应目录并选择 manifest.json：
   • Photoshop：uxp/ps/manifest.json
   • Premiere Pro：uxp/pr/manifest.json
   • InDesign：uxp/id/manifest.json
5. 点击 加载
6. 在您的 Adobe 应用程序中，打开插件面板并点击 连接

在 Photoshop 中启用开发者模式

对于 Photoshop：

1. 启动 Photoshop（2025/26.0 或更高版本）
2. 前往 设置 > 插件，勾选 “启用开发者模式”
3. 重启 Photoshop

AfterEffects、Illustrator（CEP）

Mac

1. 确保以下目录存在（如果不存在则创建这些目录）：
   /Users/USERNAME/Library/Application Support/Adobe/CEP/extensions

2. 进入 extensions 目录，创建一个指向 CEP 目录中 AfterEffect 或 Illustrator 插件的符号链接。

cd /Users/USERNAME/Library/Application Support/Adobe/CEP/extensions
ln -s /Users/USERNAME/src/adb-mcp/cep/com.mikechambers.ae com.mikechambers.ae

或

cd /Users/USERNAME/Library/Application Support/Adobe/CEP/extensions
ln -s /Users/USERNAME/src/adb-mcp/cep/com.mikechambers.ai com.mikechambers.ai

Windows

1. 确保以下目录存在（如果不存在则创建这些目录）：
   C:\Users\USERNAME\AppData\Roaming\Adobe\CEP\extensions

2. 以管理员身份打开命令提示符（或在 Windows 设置中启用开发者模式）

3. 创建一个连接点或符号链接，指向 CEP 目录中的 AfterEffect 或 Illustrator 插件：

mklink /D "C:\Users\USERNAME\AppData\Roaming\Adobe\CEP\extensions\com.mikechambers.ae" "C:\Users\USERNAME\src\adb-mcp\cep\com.mikechambers.ae"

或

mklink /D "C:\Users\USERNAME\AppData\Roaming\Adobe\CEP\extensions\com.mikechambers.ai" "C:\Users\USERNAME\src\adb-mcp\cep\com.mikechambers.ai"

注意：如果您不想使用符号链接，也可以将 com.mikechambers.ae 或 com.mikechambers.ai 复制到 CEP 目录中。

在 Adobe 应用中使用 Claude

启动以下内容：

1. Claude Desktop
2. adb-proxy-socket Node.js 服务器
3. 启动 Photoshop、Premiere、InDesign、AfterEffects、Illustrator

提示：在 Claude 中为 Photoshop 或 Premiere Pro 创建一个项目，并预先将该应用特定的指令加载到项目的知识库中。

Photoshop

1. 启动 UXP 开发者工具，点击 Photoshop MCP Agent 的加载按钮
2. 在 Photoshop 中，如果 MCP Agent 面板未打开，请前往 插件 > Photoshop MCP Agent > Photoshop MCP Agent 打开它
3. 在 Photoshop 的代理面板中点击“连接”

现在您可以切换到 Claude Desktop。在开始会话之前，您应该通过点击插座图标（从 MCP 附加），然后选择 选择集成 > Adobe Photoshop > config://get_instructions，加载指令资源，以便为 Claude 提供指导和信息。

Premiere

1. 启动 UXP 开发者工具，点击 Premiere MCP Agent 的加载按钮
2. 在 Premiere 中，如果 MCP Agent 面板未打开，请前往 窗口 > UXP 插件 > Premiere MCP Agent > Premiere MCP Agent 打开它
3. 在 Premiere 的代理面板中点击“连接”

InDesign

1. 启动 UXP 开发者工具，点击 InDesign MCP Agent 的加载按钮
2. 在 InDesign 中，如果 MCP Agent 面板未打开，请前往 插件 > InDesign MCP Agent > InDesign MCP Agent 打开它
3. 在 InDesign 的代理面板中点击“连接”

AfterEffects

1. 窗口 > 扩展功能 > Illustrator MCP Agent

Illustrator

1. 打开一个文件（除非有文件打开，否则插件不会启动）
2. 窗口 > 扩展功能 > Illustrator MCP Agent

请注意，每次重启 Photoshop、Premiere 和 InDesign 时，都必须通过 UXP 开发者应用程序重新加载插件。

设置会话

在聊天输入框中，点击“+”按钮。然后选择“从 Adobe Photoshop / Premiere 添加”，再选择 config://get_instructions。这会将指令加载到提示中。提交给 Claude，待其处理完毕后，您就可以开始使用了。

这将有助于减少 AI 在使用应用程序时出现的错误。

提示方法

在任何时候，您都可以询问以下问题：

你能列出可用于操作 Photoshop / Premiere 的 API / 函数吗？

AI 将会列出所有可用的功能。

在进行提示时，无需引用 API，只需使用自然语言给出指令即可。

例如：

创建一个蓝色背景的新 Photoshop 文件，尺寸为 1080×720，分辨率为 300 dpi。

为 Instagram 发布创建一个新的 Photoshop 文件。

在 Photoshop 中制作一张女性与森林的双重曝光图像。

生成一张森林的图像，然后添加剪贴蒙版，只显示中间圆形区域。

用 Photoshop 做点酷炫的东西吧。

在 Premiere 的时间线上所有片段之间添加交叉淡入淡出过渡效果。

小贴士

通用

• 当你让AI查看Photoshop或Premiere Pro中的内容时，返回的图像会显示在聊天中的“工具调用”项中。只有当整个回复都添加到聊天中后，它才会出现。
• 在提示AI时，可以要求它思考并检查自己的工作。
• 你提供的指导越多（例如“考虑使用剪贴蒙版”），结果就会越好。
• 模型越先进，或者分配给模型的资源越多，AI的表现就越出色、越有创意。
• 一般情况下，在AI执行任务时不要在Adobe应用程序中进行更改。如果确实需要更改，请务必告知AI。
• AI会从错误中学习，但每次开始新对话时都会丢失记忆。你可以引导它以不同的方式完成任务，然后让它重新开始，它应该会遵循新的方法。

目前，AI可以访问Photoshop、Premiere、InDesign、Illustrator和After Effects的部分功能。总体来说，这种方法是提供较低级别的工具，以便AI掌握基础操作，从而完成更复杂的任务。

需要注意的是，对于After Effects和Illustrator，有一个低级别的Extend Script API，可以让大型语言模型运行任意的Extend脚本，从而实现几乎任何操作。

Photoshop插件的功能比Premiere更多。

默认情况下，AI无法直接访问文件，不过如果你安装了Claude文件系统MCP服务器，它就可以访问并加载文件到Photoshop或Premiere中（打开文件并嵌入图像）。

Photoshop

• 你可以让AI查看Photoshop文件的内容，它应该能够看到输出结果。
• 目前AI在正确调整文本大小和位置方面存在问题，因此提供字体大小的指导建议会有帮助，同时也可以告诉AI将文本相对于画布对齐。
• AI可以访问系统上所有的PostScript字体。如果要指定某种字体，必须使用其PostScript名称（你也可以请AI帮你查找）。
• 你可以向AI寻求建议。它有时会提出非常有用的想法或反馈。

Premiere

• 目前插件假设你只处理一个序列。
• 将Premiere Pro MCP与media-utils-mcp配合使用，可以扩展功能。

故障排除

MCP无法在Claude中运行

如果在运行Claude时出现MCP无法正常工作的错误，你可能需要编辑Claude的配置文件，并为UV命令设置绝对路径。更多信息请参见这里。

并非所有字体都可用

MCP服务器会返回可用字体的列表，但根据你系统上安装的字体数量，可能会省略部分字体，以避免发送过多数据给AI。默认情况下，它会列出按字母顺序排列的前1000种字体。

你可以通过指定字体的PostScript名称来让AI使用特定字体。

插件无法安装或连接

• 确保在尝试加载插件之前，应用程序已经运行。
• 在UXP开发者工具中，点击“加载”旁边的调试按钮，查看是否有错误信息。
• 确保节点/代理服务器正在运行。如果插件成功连接，你应该会看到类似以下的输出：

adb-mcp 命令代理服务器正在 ws://localhost:3001 上运行
用户已连接：Ud6L4CjMWGAeofYAAAAB
客户端 Ud6L4CjMWGAeofYAAAAB 已注册到 photoshop 应用程序

• 当你按下连接按钮时，如果仍然显示“连接”，则表示出现了错误，或者无法连接到代理服务器。你可以在UXP开发者应用中查看错误信息，打开开发者工作区并点击“调试”。

AI客户端内部的错误

• 如果AI端出现问题，它通常会告诉你具体原因。点击命令/代码框即可查看错误信息。
• 遇到问题时，首先要检查Photoshop或Premiere中的插件是否已连接，以及节点代理服务器是否正在运行。
• 如果响应时间变得非常慢，检查AI服务器是否负载过高，同时确保当前对话中的文本量不要过大（有时重新开始一次新对话可以帮助加快速度，但你会失去之前的上下文）。

如果你仍然遇到问题，请在Github仓库上提交一个问题。请尽可能提供详细信息（操作系统、应用程序、应用程序版本以及调试信息或错误）。

开发

添加新功能相对容易，只需按照以下步骤操作：

1. 在mcp/ps-mcp.py或mcp/pr-mcp.py文件中添加API和参数（这些文件供AI调用）。
2. 在uxp/ps/commands/index.js或uxp/pr/commands/index.js文件中实现该API。

这个讨论帖提供了关于如何添加功能的一些信息。

问题、功能请求、反馈

如果你有任何问题、功能请求、需要帮助，或者只是想聊一聊，欢迎加入我们的Discord服务器。

你也可以在Github仓库的问题页面上记录Bug和功能请求。

许可证

该项目采用MIT许可证发布。

adb-mcp 快速上手指南

adb-mcp 是一个概念验证项目，旨在通过 MCP（Model Context Protocol）协议让 AI（如 Claude）直接控制 Adobe 系列软件（Photoshop、Premiere Pro 等）。它允许用户通过自然语言指令让 AI 执行复杂的编辑任务、生成教程或自动化工作流。

注意：本项目非 Adobe 官方出品，也不受其支持。

环境准备

在开始之前，请确保您的系统满足以下要求：

系统要求

• 操作系统：macOS (Intel/Apple Silicon) 或 Windows
• Adobe 软件：
  • Photoshop 26.0 或更高版本
  • Premiere Pro Beta (25.3 Build 46 或更高版本)
  • 或其他支持的 Adobe 应用 (InDesign, AfterEffects, Illustrator)

前置依赖

您需要安装以下开发工具：

1. Python 3：用于运行 MCP 服务器。
2. Node.js：用于运行命令代理服务器（Proxy Server）。
3. uv：Python 包管理工具（推荐用于快速安装依赖）。
4. Adobe UXP Developer Tool：通过 Creative Cloud 安装，用于加载和调试插件。
5. 支持 MCP 的 AI 客户端：例如 Claude Desktop 或 OpenAI Agent SDK。

安装步骤

1. 获取源代码

克隆或下载项目代码：

git clone https://github.com/mikechambers/adb-mcp.git
cd adb-mcp

2. 配置 MCP 服务器

根据您的目标软件，运行相应的安装命令。以下以 Photoshop 和 Premiere Pro 为例（其他软件请参考 README 中的对应命令）：

Photoshop:

uv run mcp install --with fonttools --with python-socketio --with mcp --with requests --with websocket-client --with numpy ps-mcp.py

Premiere Pro:

uv run mcp install --with fonttools --with python-socketio --with mcp --with requests --with websocket-client --with pillow pr-mcp.py

安装完成后，请重启 Claude Desktop。

3. 启动代理服务器 (Proxy Server)

MCP 服务器需要通过一个 Node.js 代理才能与 Adobe 插件通信。您可以选择使用预编译文件或从源码运行。

方式 A：使用预编译可执行文件（推荐）

1. 前往 Releases 页面 下载对应系统的压缩包（如 adb-proxy-socket-macos-arm64.zip）。
2. 解压并双击运行，或在终端中运行该可执行文件。

方式 B：从源码运行

cd adb-proxy-socket
node proxy.js

成功启动后，您应看到类似提示：Photoshop MCP Command proxy server running on ws://localhost:3001。请保持此窗口运行。

4. 安装 Adobe 插件

使用 UXP Developer Tool 加载插件：

1. 打开 UXP Developer Tool。
2. 选择 File > Add Plugin。
3. 导航至项目目录下的对应 manifest.json 文件：
   • Photoshop: uxp/ps/manifest.json
   • Premiere Pro: uxp/pr/manifest.json
4. 点击 Load。
5. 启用开发者模式（仅限 Photoshop）：
   • 打开 Photoshop，进入 Settings > Plugins，勾选 "Enable Developer Mode" 并重启软件。

注意：对于 AfterEffects 和 Illustrator，需通过创建符号链接将 cep 目录下的插件文件夹映射到 Adobe 扩展目录，具体命令请参考原文 README 的 "Install Plugins" 章节。

基本使用

完成上述配置后，按以下顺序启动服务：

1. 运行 adb-proxy-socket (保持后台运行)。
2. 启动 Claude Desktop。
3. 打开 Photoshop (或 Premiere 等)，在插件面板中找到 "MCP Agent" 并点击 Connect。

建立会话

在 Claude Desktop 的聊天输入框中：

1. 点击 "+" 按钮。
2. 选择 Attach from MCP (或类似集成选项)。
3. 选择 Adobe Photoshop > config://get_instructions。
4. 发送该消息，让 AI 加载功能指令集。

使用示例

加载指令后，您可以直接使用自然语言下达复杂指令，无需提及具体 API。

示例 1：创建基础文件

创建一个全新的 Photoshop 文件，背景为蓝色，尺寸宽 1080 高 720，分辨率 300 dpi。

示例 2：创意任务

在 Photoshop 中制作一张双重曝光图片，主体是一位女性，背景是森林。

示例 3：视频编辑 (Premiere)

在 Premiere 时间轴的所有剪辑之间添加交叉淡入淡出过渡效果。

示例 4：查询能力

列出当前可用于操作 Photoshop 的所有 API 或函数。

实用技巧

• 查看结果：当 AI 执行截图或图像生成任务时，结果会显示在聊天的 "Tool Call" 项中。
• 引导优化：如果 AI 排版不准确，可以提示它“考虑使用剪贴蒙版”或“相对于画布居中对齐”。
• 避免干扰：在 AI 执行任务期间，尽量不要手动操作 Adobe 软件，以免状态不同步。如需修改，请告知 AI。
• 文件访问：默认情况下 AI 无法直接读取本地文件。如需让 AI 打开图片或素材，建议额外安装 Claude File System MCP server。