Adb MCP

🚀 adb - mcp

adb - mcp 是一個概念驗證項目，旨在通過 MCP 協議為大語言模型（LLMs）提供接口，從而為 Adobe 工具（Adobe Photoshop 和 Adobe Premiere）創建 AI 代理。

該項目未得到 Adobe 的認可或支持。

此項目已在 Anthropic 的 Claude 桌面版（Mac 和 Windows）上進行了測試，可讓 Claude 控制 Adobe Photoshop 和 Adobe Premiere。理論上，它應能與任何支持 MCP 協議的 AI 應用程序/大語言模型配合使用，並且其架構設計支持多個 Adobe 應用程序。

示例用例包括：

• 逐步指導 Claude 在 Photoshop 中執行操作，提供基於對話的界面（如果您是 Photoshop 新手，這特別有用）。
• 給 Claude 分配任務（創建一張類似寶麗來照片的 Instagram 帖子、創建雙重曝光效果），讓它從頭到尾完成任務，作為模板使用。
• 讓 Claude 為您生成自定義的 Photoshop 教程，方法是創建一個示例文件，然後逐步說明如何重現。
• 作為 Photoshop 實用工具（讓 Claude 將您所有的圖層重命名為一致的格式）。
• 讓 Claude 創建預填充了剪輯、過渡效果、特效和音頻的 Premiere 新項目。

查看視頻示例

目前，對於 Photoshop，AI 代理可以從 Photoshop 獲取一些信息，從而檢查其操作。然而，它無法自動查看其操作結果（即從 Photoshop 獲取圖像）。這應該是可行的，但尚未實現。在此期間，您可以將內容從 Photoshop 複製並粘貼到 Claude 桌面版中。

由於 Premiere 插件 API 當前的限制，與 Photoshop 代理相比，Premiere 代理的功能稍有限制。

🚀 快速開始

工作原理

概念驗證的實現方式如下：

• 一個 MCP 服務器，為 AI/大語言模型提供訪問 Adobe Photoshop 功能的接口。
• 一個基於 Node 的命令代理服務器，位於 MCP 服務器和 Adobe 應用程序插件之間。
• 一個 Adobe 應用程序（Photoshop 和 Premiere）插件，用於監聽命令並驅動程序。

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

需要代理服務器是因為基於 UXP 的 JavaScript 插件的公共 API 不允許它以服務器的身份監聽套接字連接（MCP 服務器需要連接到該套接字），它只能作為客戶端連接到套接字。

要求

要運行此項目，需要滿足以下條件：

• 支持 MCP 協議的 AI 大語言模型（已在 Mac 和 Windows 上的 Claude 桌面版進行測試）。
• Python 3，用於運行本項目提供的 MCP 服務器。
• NodeJS，用於在 MCP 服務器和 Photoshop 之間提供代理。
• Adobe UXP 開發工具（可通過 Creative Cloud 獲取），用於安裝和調試連接到代理的 Photoshop / Premiere 插件。
• 安裝了 MCP 插件的 Adobe Photoshop（26.0 或更高版本）或 Adobe Premiere 測試版（25.3 版本 46 或更高版本）。

安裝指南

本項目是使用 Claude 桌面版進行開發和測試的，假設您也將使用它。使用其他支持 MCP 的 AI 應用程序應該也是可行的。

下載 adp - mcp

下載 adp - mcp 項目，並將其解壓到您想要保存的位置。

Claude 桌面版

下載並安裝 Claude 桌面版。安裝完成後，啟動它以確保一切正常。

MCP 服務器

確保您的系統已安裝並配置了 Python3（在系統的 PATH 中）。這裡假設您使用 [uv](https://github.com/astral - sh/uv) 進行包管理，並且已經在系統上進行了設置和配置。

切換到 mcp 目錄並啟動開發服務器：

Photoshop

$cd mcp
$uv run mcp dev ps - mcp.py

Premiere

$cd mcp
$uv run mcp dev pr - mcp.py

現在，您可以在 http://localhost:5173 上加載開發界面，點擊“連接”，然後在“資源”下點擊“config://get_instructions”。這應該會列出一堆 JSON 信息。如果列出了，說明一切都已正常工作和配置。

現在我們可以將其安裝到 Claude 桌面版中。

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

如果您的 Claude 桌面版正在運行，請關閉它（確保它沒有在後臺運行），然後重新啟動。如果它沒有錯誤地啟動，那麼您就可以繼續了。

此時，您還需要安裝其他一些東西。

命令代理 Node 服務器

確保您的系統已安裝並配置了 NodeJS（在系統的 PATH 中）。

切換到 adb - proxy - socket 目錄。安裝依賴項，然後啟動服務器：

$cd adb - proxy - socket
$npm install
$node proxy.js

您應該會看到一條類似於“Photoshop MCP 命令代理服務器正在 ws://localhost:3001 上運行”的消息。

Claude 要與插件進行通信，此代理必須正在運行。

Adobe 應用程序插件

Photoshop

在 Photoshop 中啟用開發者模式：

1. 啟動 Photoshop（26.0 或更高版本）。
2. 選擇“設置 > 插件”，並勾選“啟用開發者模式”。
3. 重啟 Photoshop。

從 Creative Cloud 桌面版安裝並啟動“UXP 開發工具”。出現提示時，啟用開發者模式。

安裝插件：

1. 選擇“文件 > 添加插件”。
2. 導航到 uxp/ps 目錄，並選擇 manifest.json 文件。
3. 插件列出後，點擊“加載”按鈕。

這應該會在 Photoshop 中加載插件。如果您沒有看到它，可以通過 Photoshop 的插件菜單打開它。

Premiere

1. 啟動 Premiere Pro 測試版（25.3）。

從 Creative Cloud 桌面版安裝並啟動“UXP 開發工具”。出現提示時，啟用開發者模式。

安裝插件：

1. 選擇“文件 > 添加插件”。
2. 導航到 uxp/pr 目錄，並選擇 manifest.json 文件。
3. 插件列出後，點擊“加載”按鈕。

這應該會在 Premiere 中加載插件。如果您沒有看到它，可以通過 Premiere 的插件菜單打開它。

使用 Claude 與 Adobe 應用程序

啟動以下程序：

1. Claude 桌面版。
2. adb - proxy - socket Node 服務器。
3. 啟動 Photoshop 和/或 Premiere。

Photoshop

4. 啟動 UXP 開發工具，點擊“Photoshop MCP 代理”的“加載”按鈕。
5. 在 Photoshop 中，如果 MCP 代理面板未打開，選擇“插件 > Photoshop MCP 代理 > Photoshop MCP 代理”打開它。
6. 在 Photoshop 的代理面板中點擊“連接”。

現在您可以切換到 Claude 桌面版。在開始會話之前，您應該加載指令資源，這將為 Claude 提供指導和信息。方法是點擊套接字圖標（從 MCP 附加），然後選擇“選擇集成” > “Adobe Photoshop” > “config://get_instructions”。

Premiere

4. 啟動 UXP 開發工具，點擊“Premiere MCP 代理”的“加載”按鈕。
5. 在 Premiere 中，如果 MCP 代理面板未打開，選擇“窗口 > UXP 插件 > Premiere MCP 代理 > Premiere MCP 代理”打開它。
6. 在 Photoshop 的代理面板中點擊“連接”。

現在您可以切換到 Claude 桌面版。在開始會話之前，您應該加載指令資源，這將為 Claude 提供指導和信息。方法是點擊套接字圖標（從 MCP 附加），然後選擇“選擇集成” > “Adobe Premiere” > “config://get_instructions”。

注意，每次重啟 Photoshop 和 Premiere 時，您都必須通過 UCP 開發應用程序重新加載插件。

設置會話

在聊天輸入字段中，點擊“從 MCP 附加”按鈕（看起來像兩個套接字）。然後點擊“選擇集成”，在“Adobe Photoshop”或“Adobe Premiere”下選擇 config://get_instructions。這將把指令加載到提示中。將其提交給 Claude，處理完成後，您就可以開始了。

提示

隨時可以提出以下問題：

Can you list what apis / functions are available for working with Photoshop / Premiere?

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

在提出提示時，您無需引用 API，只需使用自然語言給出指令即可。

例如：

Create a new Photoshop file with a blue background, that is 1080 width by 720 height at 300 dpi

Create a new Photoshop file for an instagram post

Create a double exposure image in Photoshop of a woman and a forest

Generate an image of a forest, and then add a clipping mask to only show the center in a circle

Make something cool with photoshop

Add cross fade transitions between all of the clips on the timeline in Premiere

使用建議

一般建議

• 提出提示時，要求 AI 思考並檢查其操作。
• 您給予的指導越多（例如“考慮使用剪貼蒙版”），結果就越好。
• 模型越先進，或者為模型提供的資源越多，AI 的表現就越好、越有創意。
• 一般來說，在 AI 工作時，不要在 Adobe 應用程序中進行更改。如果您確實進行了更改，請務必告知 AI。
• AI 會從錯誤中學習，但開始新聊天時會丟失記憶。您可以指導它以不同的方式做事，然後讓它重新開始，它應該會遵循新的方法。

目前，AI 可以訪問 Photoshop / Premiere 功能的一部分。一般來說，我們的方法是提供底層工具，讓 AI 具備完成更復雜任務的基礎。

Photoshop 插件的功能比 Premiere 更多。

默認情況下，AI 不能直接訪問文件，不過，如果您安裝了 Claude 文件系統 MCP 服務器，它就可以訪問文件並將其加載到 Photoshop / Premiere 中（打開文件並嵌入圖像）。

Photoshop

• 您可以將圖像從 Photoshop 複製並粘貼到 AI 中，以便它更好地瞭解情況。
• 目前，AI 在正確調整文本大小和位置方面存在問題，因此為它提供使用的字體大小指南，以及告知它相對於畫布對齊文本會有所幫助。
• AI 可以訪問系統上的所有 Postscript 字體。如果您想指定一種字體，必須使用其 Postscript 名稱（您可以向 AI 詢問）。
• 您可以向 AI 徵求建議。有時它會提出非常有用的想法和反饋。

Premiere

• 目前，插件假設您只處理單個序列。

故障排除

MCP 在 Claude 中無法運行

如果在運行 Claude 時出現 MCP 無法正常工作的錯誤，您可能需要編輯您的 Claude 配置文件，併為 UV 命令指定絕對路徑。更多信息[點擊這裡](https://github.com/mikechambers/adb - mcp/issues/5#issuecomment - 2829817624)。

插件無法安裝或連接

• 嘗試加載插件之前，確保應用程序正在運行。
• 在 UXP 開發工具中，點擊加載按鈕旁邊的調試按鈕，查看是否有錯誤。
• 確保 Node / 代理服務器正在運行。如果插件連接成功，您應該會看到類似以下的輸出：

adb - mcp Command proxy server running on ws://localhost:3001
User connected: Ud6L4CjMWGAeofYAAAAB
Client Ud6L4CjMWGAeofYAAAAB registered for application: photoshop

• 當您按下連接按鈕時，如果仍然顯示“連接”，則表示要麼出現了錯誤，要麼無法連接到代理服務器。

AI 客戶端內的錯誤

• 如果 AI 端出現故障，它通常會告知您問題所在。如果您點擊命令/代碼框，可以查看錯誤信息。
• 如果出現問題，首先要檢查的是確保 Photoshop / Premiere 中的插件已連接，並且 Node 代理服務器正在運行。
• 如果響應時間變得非常慢，請檢查 AI 服務器是否負載過高，並且確保當前對話中沒有過多文本（有時重新開始新聊天可以加快速度，但您會丟失上下文）。

如果您仍然遇到問題，請在 Discord 上發佈[問題](https://github.com/mikechambers/adb - mcp/issues)。請儘可能提供詳細信息（操作系統、應用程序、應用程序版本以及調試信息或錯誤）。

🔧 技術細節

添加新功能相對容易，需要以下步驟：

1. 在 mcp/ps - mcp.py / mcp/pr - mcp.py 文件中添加 API 和參數（供 AI 使用）。
2. 在 uxp/ps/commands/index.js / uxp/pr/commands/index.js 文件中實現 API。

待完成

💬 問題、功能請求和反饋

如果您有任何問題、功能請求、需要幫助或只是想聊天，請加入 Discord。

您也可以在 [問題頁面](https://github.com/mikechambers/adb - mcp/issues) 上記錄錯誤和功能請求。

📄 許可證

本項目根據 MIT 許可證 發佈。