使用说明

项目简介

adb-mcp 是一个概念验证项目，旨在通过 Model Context Protocol (MCP) 协议为 Adobe Photoshop 和 Adobe Premiere Pro 创建 AI Agent 后端服务。它允许支持 MCP 协议的 LLM（如 Claude Desktop）控制 Adobe 创意软件，实现更智能化的工作流程。

主要功能点

资源管理: 提供配置信息和操作指南等资源 (Resources)，帮助 LLM 理解可用的功能和使用方法。
工具注册与执行: 注册并暴露 Adobe Photoshop 和 Premiere Pro 的多种操作工具 (Tools)，例如创建图层、应用滤镜、编辑时间线等，使 LLM 能够通过调用这些工具来控制软件。
命令代理: 通过 Node.js 命令代理服务器，桥接 MCP 服务器和 Adobe 应用程序插件，解决 UXP 插件无法直接监听 Socket 连接的问题。
支持多种Adobe应用: 目前支持 Adobe Photoshop 和 Adobe Premiere Pro，理论上可以扩展到更多 Adobe 应用。

安装步骤

下载项目: 下载 'adb-mcp' 仓库代码并解压到本地目录。
安装 Claude Desktop: 安装并启动 Claude Desktop（已测试兼容）。
安装 MCP 服务器 (Python):
- 确保已安装 Python 3 和 NodeJS。
- 进入 'mcp' 目录，根据需要编辑 'ps-mcp.py' (Photoshop) 或 'pr-mcp.py' (Premiere) 文件（如需修改代理服务器地址）。
- 运行相应的安装命令安装依赖：
  - Photoshop: 'uv run mcp install --with fonttools --with python-socketio --with mcp --with requests --with websocket-client ps-mcp.py'
  - Premiere: 'uv run mcp install --with fonttools --with python-socketio --with mcp --with requests --with websocket-client pr-mcp.py'
启动 MCP 服务器:
- Photoshop: 'uv run mcp dev ps-mcp.py'
- Premiere: 'uv run mcp dev pr-mcp.py'
安装 Command Proxy 服务器 (Node.js):
- 进入 'adb-proxy-socket' 目录。
- 运行 'npm install' 安装依赖。
- 运行 'node proxy.js' 启动代理服务器。
安装 Adobe 插件 (UXP Developer Tool):
- 启动 Creative Cloud Desktop 并安装 "UXP Developer Tools"。
- 启动 Photoshop (26.0+) 或 Premiere Pro Beta (25.3+)，并在插件设置中启用开发者模式。
- 在 UXP Developer Tools 中，选择 "File > Add Plugin"，分别导航到 'uxp/ps' 或 'uxp/pr' 目录，选择 'manifest.json' 文件并加载插件。

服务器配置 (MCP 客户端配置)

MCP 客户端（如 Claude Desktop）需要配置 MCP 服务器的启动命令才能连接。以下是针对 Photoshop 和 Premiere Pro 的服务器配置示例 (JSON 格式)，客户端需要根据实际使用场景选择其一进行配置：

Photoshop MCP 服务器配置:

{
  "server name": "adb-mcp-photoshop",
  "command": "uv run mcp dev ps-mcp.py",
  "args": [],
  "description": "启动 Photoshop MCP 服务器"
}

Premiere Pro MCP 服务器配置:

{
  "server name": "adb-mcp-premiere",
  "command": "uv run mcp dev pr-mcp.py",
  "args": [],
  "description": "启动 Premiere Pro MCP 服务器"
}

基本使用方法

确保 Claude Desktop, adb-proxy-socket 代理服务器，以及 Photoshop 或 Premiere Pro 和相应的插件都已启动并连接。
在 Claude Desktop 中，点击 "Attach from MCP" 按钮，选择 "Choose an integration"，然后根据使用的 Adobe 软件选择 "Adobe Photoshop" 或 "Adobe Premiere"，并加载 'config://get_instructions' 资源。
向 Claude Desktop 发送自然语言指令，例如：
- Photoshop: "创建一个 Instagram 风格的宝丽来照片"
- Premiere: "在 Premiere 中为所有时间线片段添加交叉溶解转场"
Claude Desktop 将通过 MCP 协议与 MCP 服务器通信，调用相应的 Photoshop 或 Premiere Pro 工具完成指令。

注意: 每次重启 Photoshop 或 Premiere Pro 后，需要通过 UXP Developer Tool 重新加载插件。

关键词