Adb MCP

🚀 adb-mcp

adb-mcp is a proof - of - concept project that creates an AI Agent for Adobe tools (Adobe Photoshop and Adobe Premiere) by offering an interface to LLMs via the MCP protocol. This project is neither endorsed nor supported by Adobe.

It has been tested with Claude desktop (Mac and Windows) from Anthropic, enabling Claude to control Adobe Photoshop and Adobe Premiere. Theoretically, it should work with any AI App / LLM supporting the MCP protocol and is designed to support multiple Adobe applications.

✨ Features

• Conversational Interface: Provide step - by - step instructions to Claude in Photoshop, especially useful for beginners.
• Automated Creation: Assign tasks to Claude like creating Instagram posts or double - exposure images, and let it complete the task from start to finish as a template.
• Tutorial Generation: Ask Claude to generate custom Photoshop tutorials by creating example files and step - by - step instructions.
• Utility Tool: Use Claude as a Photoshop utility, such as renaming layers in a consistent format.
• Premiere Project Creation: Have Claude create new Premiere projects pre - populated with clips, transitions, effects, and audio.

View Video Examples

🚀 Quick Start

How it works

The proof - of - concept operates through the following components:

• MCP Server: Offers an interface to the functionality within Adobe Photoshop for the AI / LLM.
• Node - based Command Proxy Server: Situated between the MCP server and Adobe app plugins.
• Adobe App Plugin: Listens for commands and drives the programs.

The communication flow is as follows: AI <-> MCP Server <-> Command Proxy Server <-> Photoshop / Premiere UXP Plugin <-> Photoshop / Premiere

The proxy server is necessary because the public - facing API for UXP - Based JavaScript plugins doesn't allow them to listen on a socket connection as a server for the MCP Server to connect to (it can only connect as a client).

📦 Installation

This project has been developed and tested with Claude Desktop, but it should be possible to use other AI apps that support MCP.

Download adp - mcp

Download the adp - mcp project and unzip it to your desired location.

Claude Desktop

Download and install Claude Desktop. Launch it to ensure everything works.

MCP Server

Ensure Python3 is installed and configured in your system PATH. Assume you are using [uv](https://github.com/astral - sh/uv) for package management and have it set up.

Change to the mcp directory and start the dev server:

Photoshop

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

Premiere

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

Load the dev interface at http://localhost:5173, click "connect", and then under "Resources" click "config://get_instructions". If it lists JSON info, everything is configured correctly.

Now install into Claude Desktop:

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

Close and restart Claude Desktop. If it starts without errors, you're good to go.

Command Proxy Node Sever

Make sure NodeJS is installed and configured in your system PATH.

Switch to the adb - proxy - socket directory, install the requirements, and start the server:

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

You should see a message like Photoshop MCP Command proxy server running on ws://localhost:3001. This proxy must be running for Claude to communicate with the plugin.

Adobe App Plugins

Photoshop

Enable developer mode in Photoshop:

1. Launch Photoshop (26.0 or greater).
2. Go to Settings > Plugins and check "Enable Developer Mode".
3. Restart Photoshop.

Install and launch "UXP Developer Tools" from Creative Cloud Desktop and enable developer mode when prompted.

Install the plugin:

1. Select File > Add Plugin.
2. Navigate to the uxp/ps directory and select the manifest.json file.
3. Click the "Load" button when the plugin is listed.

If you don't see the plugin, open it via the plugins menu in Photoshop.

Premiere

1. Launch Premiere Pro Beta (25.3).

Install and launch "UXP Developer Tools" from Creative Cloud Desktop and enable developer mode when prompted.

Install the plugin:

1. Select File > Add Plugin.
2. Navigate to the uxp/pr directory and select the manifest.json file.
3. Click the "Load" button when the plugin is listed.

If you don't see the plugin, open it via the plugins menu in Premiere.

💻 Usage Examples

Launch the Applications

1. Launch Claude Desktop.
2. Start the adb - proxy - socket node server.
3. Launch Photoshop and / or Premiere.

Photoshop

4. Launch UXP Developer Tool and click the Load button for Photoshop MCP Agent.
5. In Photoshop, if the MCP Agent panel is not open, open Plugins > Photoshop MCP Agent > Photoshop MCP Agent.
6. Click connect in the agent panel in Photoshop.

Before starting a session in Claude Desktop, click the socket icon (Attach from MCP), then Choose an Integration > Adobe Photoshop > config://get_instructions to load the instructions.

Premiere

4. Launch UXP Developer Tool and click the Load button for Premiere MCP Agent.
5. In Premiere, if the MCP Agent panel is not open, open Window > UXP Plugins > Premiere MCP Agent > Premiere MCP Agent.
6. Click connect in the agent panel in Photoshop.

Before starting a session in Claude Desktop, click the socket icon (Attach from MCP), then Choose an Integration > Adobe Premiere > config://get_instructions to load the instructions.

Note: You must reload the plugin via the UCP Developer app every time you restart Photoshop and Premiere.

Setting up session

In the chat input field, click the "Attach from MCP" button. Then click "Choose and integration" and select config://get_instructions under "Adobe Photoshop" or "Adobe Premiere". Submit the prompt to Claude, and you're ready to go.

Prompting

You can ask questions like:

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

When prompting, use natural language. For example:

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

Tips

💡 Usage Tip

• General: - Ask the AI to think about and check its work when prompting. - Provide more guidance for better results. - Use more advanced models or allocate more resources for better and more creative outputs. - Avoid making changes in Adobe Apps while the AI is working. If you do, inform the AI. - The AI learns from mistakes but loses memory in a new chat. You can guide it to change the approach. - The AI currently has access to a subset of Photoshop / Premiere functionality, with a focus on providing basic tools for complex tasks. The Photoshop plugin has more functionality than Premiere. - By default, the AI can't access files directly. Install the Claude File System MCP server to enable file access.

• Photoshop:
  • Copy and paste images from Photoshop into the AI for more information.
  • Guide the AI on font sizes and text alignment as it has issues with sizing and positioning text.
  • The AI can access all Postscript fonts. Use the Postscript name when specifying a font.
  • Ask the AI for suggestions.
• Premiere:
  • The plugin currently assumes you're working with a single sequence.

Troubleshooting

⚠️ Important Note

• MCP won't run in Claude: If you get an error, you may need to edit your Claud config file and set an absolute path for the UV command. [More info](https://github.com/mikechambers/adb - mcp/issues/5#issuecomment - 2829817624).

• Plugin won't install or connect:
  • Ensure the app is running before loading the plugin.
  • Click the debug button in the UXP developer tool to check for errors.
  • Make sure the node / proxy server is running. If the plugin connects, you should see relevant output.
  • If the connect button remains "connect" after clicking, there may be an error or a connection issue with the proxy server.
• Errors within AI client:
  • If the AI fails, it usually indicates the issue. Click the command / code box to see the error.
  • Check if the plugin in Photoshop / Premiere is connected and the node proxy server is running.
  • If response times are slow, check if the AI servers are under load and limit the text in the conversation. Restarting a new chat may help but will lose context.

If you still have issues, post an Issue on Discord with as much information as possible (OS, App, App version, debug info, or errors).

🔧 Technical Details

Adding new functionality is relatively easy and requires:

1. Adding the API and parameters in the mcp/ps - mcp.py / mcp/pr - mcp.py file (used by the AI).
2. Implementing the API in the uxp/ps/commands/index.js / uxp/pr/commands/index.js file.

📚 Documentation

If you have any questions, feature requests, need help, or just want to chat, join the discord. You can also log bugs and feature requests on the [issues page](https://github.com/mikechambers/adb - mcp/issues).

📄 License

Project released under a MIT License.