STARWARCLOUD STARWAR.AI
返回市场
ADB-MCP

ADB-MCP

作者：mikechambers412 星标更新：2025-10-04
安装使用来源：spider==github.com

项目介绍

adb-mcp

adb-mcp 是一个概念验证项目，通过 MCP 协议提供接口，使 AI 能够控制 Adobe 工具（如 Adobe Photoshop 和 Adobe Premiere）。

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

已经使用 Anthropic 的 Claude 桌面版（Mac 和 Windows）以及 OpenAI Agent SDK 进行了测试，允许 AI 客户端控制 Adobe Photoshop 和 Adobe Premiere。理论上，它应该能够与任何支持 MCP 协议的 AI 应用程序 / 大型语言模型配合工作，并且构建方式支持多个 Adobe 应用程序。

示例用例包括：

  • 给 Claude 提供逐步操作 Photoshop 的指令，提供基于对话的界面（对于 Photoshop 新手特别有用）。
  • 给 Claude 分配任务（创建一张看起来像宝丽来照片的 Instagram 帖子，创建双曝光图像），并让其从头到尾完成以作为模板。
  • 请求 Claude 为您生成自定义的 Photoshop 教程，通过创建示例文件，然后提供逐步操作说明。
  • 作为一种 Photoshop 实用工具（让 Claude 将所有图层重命名为一致的格式）。
  • 让 Claude 创建新的 Premiere 项目，预填充片段、过渡效果、音频等。

查看视频示例

Premiere 代理的功能相比 Photoshop 代理稍有局限，这是由于当前 Premiere 插件 API 的限制所致。

工作原理

概念验证的工作方式如下：

  • 一个 MCP 服务器，向 AI / 大型语言模型提供访问 Adobe Photoshop 功能的接口。
  • 一个基于节点的命令代理服务器，位于 MCP 服务器和 Adobe 应用插件之间。
  • 一个 Adobe 应用插件（Photoshop 和 Premiere），监听命令并驱动程序。

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

代理服务器是必需的，因为面向公众的 UXP 基于 JavaScript 的插件 API 不允许它作为一个服务器监听套接字连接（只能作为客户端连接到套接字）。

需求

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

  • 支持 MCP 协议的 AI 大型语言模型（已使用 Mac 和 Windows 上的 Claude 桌面版以及 OpenAI Agent SDK 进行测试）
  • Python 3，用于运行本项目提供的 MCP 服务器
  • NodeJS，用于在 MCP 服务器和 Photoshop 之间提供代理
  • Adobe UXP 开发者工具（可通过 Creative Cloud 获取），用于安装和调试 Photoshop / Premiere 插件，以便连接到代理
  • Adobe Photoshop（版本 26.0 或更高）或 Adobe Premiere Beta（版本 25.3 构建 46 或更高），需安装 MCP 插件

安装

本指南假设您正在使用 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. 从最新 发布 中下载适用于您平台的可执行文件（文件名类似于 adb-proxy-socket-macos-x64.zip（Intel），adb-proxy-socket-macos-arm64.zip（Apple 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. 导航至扩展目录并创建一个指向 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. 创建一个指向 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 目录中。

使用 Claude 与 Adobe 应用程序

启动以下内容：

  1. Claude 桌面版
  2. adb-proxy-socket 节点服务器
  3. 启动 Photoshop, Premiere, InDesign, AfterEffects, Illustrator

提示： 在 Claude 中创建一个针对 Photoshop / Premiere Pro 的项目，并预先加载任何特定应用的指令到其项目知识中。

Photoshop

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

现在您可以切换到 Claude 桌面版。在开始会话之前，您应该加载指令资源，这将为 Claude 提供指导和信息。点击套接字图标（从 MCP 连接）然后选择 选择集成 > Adobe Photoshop > config://get_instructions。

Premiere

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

InDesign

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

AfterEffects

  1. 窗口 > 扩展 > Illustrator MCP 代理

Illustrator

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

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

设置会话

在聊天输入字段中，点击“+”按钮。从那里点击“从 Adobe Photoshop / Premiere 添加”，然后选择 config://get_instructions。这将加载指令到提示中。提交给 Claude 并处理后，您就可以开始了。

<img src="images/claud-attach-mcp.png" width="300">

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

提示

随时，您可以询问以下内容：

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

它将列出所有可用的功能。

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

例如：

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

创建一个新的 Photoshop 文件用于 Instagram 帖子

在 Photoshop 中创建一张女性和森林的双曝光图像

生成一张森林的图片，然后添加剪切蒙版仅显示中心的圆形部分

用 Photoshop 制作一些酷炫的东西

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

提示

通用

  • 当请求 AI 查看 Photoshop / Premiere Pro 内容时，您可以在聊天中的工具调用项中看到返回的图像。一旦整个响应被添加到聊天中，它就会出现。
  • 在提示时，要求 AI 思考并检查其工作。
  • 您越引导它（例如，“考虑使用剪切蒙版”），结果越好。
  • 模型越先进，或者给予模型的资源越多，AI 就越能发挥创意。
  • 一般而言，在 AI 正在工作时不要在 Adobe 应用程序中进行更改。如果您确实进行了更改，请务必告知 AI。
  • AI 会从错误中学习，但一旦您开始新的聊天，它就会失去记忆。您可以引导它以不同的方式做事，然后要求它重新开始，它应该遵循新方法。

目前，AI 对 Photoshop / Premiere / InDesign / Illustrator / AfterEffects 功能的访问是有限的。总的来说，方法是提供低级工具，使 AI 能够进行更复杂的操作。

请注意，对于 AfterEffects 和 Illustrator，有一个低级的 Extend Script API，可以让大型语言模型运行任意的扩展脚本（这几乎可以做任何事情）。

Photoshop 插件的功能比 Premiere 更多。

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

Photoshop

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

Premiere

  • 目前，插件假定您只是在一个序列上工作。
  • 将 Premiere Pro MCP 与 media-utils-mcp 结合使用以扩展功能。

故障排除

MCP 在 Claude 中无法运行

如果您在运行 Claude 时收到 MCP 无法工作的错误，您可能需要编辑 Claude 配置文件，并为 UV 命令放置绝对路径。更多信息请参阅 这里。

字体不全

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

您可以告诉 AI 使用特定字体，使用其 PostScript 名称。

插件无法安装或连接

  • 确保在尝试加载插件之前应用程序正在运行。
  • 在 UXP 开发者工具中点击加载旁边的调试按钮，查看是否有任何错误。
  • 确保 node / 代理服务器正在运行。如果插件连接成功，您应该看到类似以下输出：
adb-mcp 命令代理服务器正在 ws://localhost:3001 上运行
用户连接：Ud6L4CjMWGAeofYAAAAB
客户端 Ud6L4CjMWGAeofYAAAAB 注册为应用程序：photoshop
  • 当您按下连接按钮时，如果仍然显示“连接”，这意味着要么有错误，要么无法连接到代理服务器。您可以在 UXP 开发者应用程序中查看错误，打开开发者工作区并点击“调试”。

AI 客户端内的错误

  • 如果 AI 方面出现问题，通常会告诉您问题所在。如果您点击命令 / 代码框，可以看到错误。
  • 如果出现问题，首先要检查的是确保 Photoshop / Premiere 中的插件已连接，并且 node 代理服务器正在运行。
  • 如果响应时间变得非常慢，请检查 AI 服务器是否处于负载状态，并确保当前对话中没有过多的文本（重新开始新的聊天有时可以帮助加快速度，但您会丢失上下文）。

如果您继续遇到问题，请在此处提交 问题。尽可能提供详细信息（操作系统、应用程序、应用程序版本以及调试信息或错误）。

开发

添加新功能相对简单，需要：

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

此 线程 包含有关如何添加功能的信息。

问题、功能请求、反馈

如果您有任何问题、功能请求、需要帮助，或只是想聊天，请加入 Discord。

您还可以在 问题页面 上记录错误和功能请求。

许可证

项目发布在 MIT 许可证下。

许可证：MIT