# mikechambers/adb-mcp architecture

> Architecture diagram of the GitHub repository mikechambers/adb-mcp, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/mikechambers/adb-mcp
- Repository: https://github.com/mikechambers/adb-mcp

## Overview

adb-mcp lets an MCP-compatible AI client issue commands to Adobe applications. Application-specific Python MCP servers expose the tools and use shared command and socket-client code; a Node proxy bridges them to plugins because UXP plugins connect as socket clients. Plugins route commands into app-specific operations and return results. The README documents the broad bridge and supported applications; sampled source confirms several UXP routing paths, but not every MCP tool-to-command mapping or the CEP internals.

Main entry points: [`mcp/core.py`](https://github.com/mikechambers/adb-mcp/blob/main/mcp/core.py) (Command core), [`adb-proxy-socket/proxy.js`](https://github.com/mikechambers/adb-mcp/blob/main/adb-proxy-socket/proxy.js) (Command proxy), [`uxp/ps/main.js`](https://github.com/mikechambers/adb-mcp/blob/main/uxp/ps/main.js) (Photoshop plugin), [`uxp/pr/main.js`](https://github.com/mikechambers/adb-mcp/blob/main/uxp/pr/main.js) (Premiere plugin)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_mcp["MCP command servers"]
  node_psmcp["Photoshop MCP<br/>[ps-mcp.py]"]
  node_prmcp["Premiere MCP<br/>[pr-mcp.py]"]
  node_idmcp["InDesign MCP<br/>[id-mcp.py]"]
  node_aemcp["After Effects MCP<br/>[ae-mcp.py]"]
  node_aimcp["Illustrator MCP<br/>[ai-mcp.py]"]
  node_batch["Photoshop batch<br/>[ps-batch-play.py]"]
end

subgraph group_bridge["Socket bridge"]
  node_proxy["Command proxy<br/>[proxy.js]"]
end

subgraph group_uxp["UXP plugins"]
  node_psplugin["Photoshop plugin<br/>[main.js]"]
  node_pscommands["Photoshop commands<br/>[layers.js]"]
  node_prplugin["Premiere plugin<br/>[main.js]"]
  node_prcommands["Premiere commands<br/>[core.js]"]
  node_idplugin["InDesign plugin<br/>[main.js]"]
  node_idcommands["InDesign commands<br/>[index.js]"]
end

subgraph group_cep["CEP plugins"]
  node_aeplugin["After Effects plugin<br/>[main.js]"]
  node_aecommands["After Effects actions<br/>[commands.js]"]
  node_aiplugin["Illustrator plugin<br/>[main.js]"]
  node_aicommands["Illustrator actions<br/>[commands.js]"]
end

subgraph group_shared["Shared MCP support"]
  node_core["Command core<br/>[core.py]"]
  node_socketclient["Socket client<br/>[socket_client.py]"]
  node_fonts["Font utilities<br/>[fonts.py]"]
  node_logger["Logger<br/>[logger.py]"]
end

node_ai(("AI client"))
node_adobe(("Adobe applications"))

node_ai -->|"requests tools"| node_psmcp
node_ai -->|"requests tools"| node_prmcp
node_psmcp -->|"uses commands"| node_core
node_prmcp -->|"uses commands"| node_core
node_idmcp -->|"uses commands"| node_core
node_aemcp -->|"uses commands"| node_core
node_aimcp -->|"uses commands"| node_core
node_batch -->|"uses commands"| node_core
node_core -->|"sends commands"| node_socketclient
node_socketclient -->|"sends packets"| node_proxy
node_proxy -->|"routes packets"| node_psplugin
node_proxy -->|"routes packets"| node_prplugin
node_proxy -->|"routes packets"| node_idplugin
node_proxy -->|"routes packets"| node_aeplugin
node_proxy -->|"routes packets"| node_aiplugin
node_psplugin -->|"routes commands"| node_pscommands
node_prplugin -->|"routes commands"| node_prcommands
node_idplugin -->|"routes commands"| node_idcommands
node_aeplugin -.->|"dispatches actions"| node_aecommands
node_aiplugin -.->|"dispatches actions"| node_aicommands
node_psplugin -->|"controls app"| node_adobe
node_prplugin -->|"controls app"| node_adobe
node_idplugin -->|"controls app"| node_adobe
node_aeplugin -->|"controls app"| node_adobe
node_aiplugin -->|"controls app"| node_adobe
node_socketclient -->|"logs events"| node_logger

click node_psmcp "https://github.com/mikechambers/adb-mcp/blob/main/mcp/ps-mcp.py"
click node_prmcp "https://github.com/mikechambers/adb-mcp/blob/main/mcp/pr-mcp.py"
click node_idmcp "https://github.com/mikechambers/adb-mcp/blob/main/mcp/id-mcp.py"
click node_aemcp "https://github.com/mikechambers/adb-mcp/blob/main/mcp/ae-mcp.py"
click node_aimcp "https://github.com/mikechambers/adb-mcp/blob/main/mcp/ai-mcp.py"
click node_batch "https://github.com/mikechambers/adb-mcp/blob/main/mcp/ps-batch-play.py"
click node_core "https://github.com/mikechambers/adb-mcp/blob/main/mcp/core.py"
click node_socketclient "https://github.com/mikechambers/adb-mcp/blob/main/mcp/socket_client.py"
click node_fonts "https://github.com/mikechambers/adb-mcp/blob/main/mcp/fonts.py"
click node_logger "https://github.com/mikechambers/adb-mcp/blob/main/mcp/logger.py"
click node_proxy "https://github.com/mikechambers/adb-mcp/blob/main/adb-proxy-socket/proxy.js"
click node_psplugin "https://github.com/mikechambers/adb-mcp/blob/main/uxp/ps/main.js"
click node_pscommands "https://github.com/mikechambers/adb-mcp/blob/main/uxp/ps/commands/layers.js"
click node_prplugin "https://github.com/mikechambers/adb-mcp/blob/main/uxp/pr/main.js"
click node_prcommands "https://github.com/mikechambers/adb-mcp/blob/main/uxp/pr/commands/core.js"
click node_idplugin "https://github.com/mikechambers/adb-mcp/blob/main/uxp/id/main.js"
click node_idcommands "https://github.com/mikechambers/adb-mcp/blob/main/uxp/id/commands/index.js"
click node_aeplugin "https://github.com/mikechambers/adb-mcp/blob/main/cep/com.mikechambers.ae/main.js"
click node_aecommands "https://github.com/mikechambers/adb-mcp/blob/main/cep/com.mikechambers.ae/commands.js"
click node_aiplugin "https://github.com/mikechambers/adb-mcp/blob/main/cep/com.mikechambers.ai/main.js"
click node_aicommands "https://github.com/mikechambers/adb-mcp/blob/main/cep/com.mikechambers.ai/commands.js"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_psmcp,node_prmcp,node_idmcp,node_aemcp,node_aimcp,node_batch,node_ai toneBlue
class node_proxy toneAmber
class node_psplugin,node_pscommands,node_prplugin,node_prcommands,node_idplugin,node_idcommands toneMint
class node_aeplugin,node_aecommands,node_aiplugin,node_aicommands toneRose
class node_core,node_socketclient,node_fonts,node_logger,node_adobe toneIndigo
```

## Components

### MCP command servers

- [Photoshop MCP](https://github.com/mikechambers/adb-mcp/blob/main/mcp/ps-mcp.py): `mcp/ps-mcp.py`
- [Premiere MCP](https://github.com/mikechambers/adb-mcp/blob/main/mcp/pr-mcp.py): `mcp/pr-mcp.py`
- [InDesign MCP](https://github.com/mikechambers/adb-mcp/blob/main/mcp/id-mcp.py): `mcp/id-mcp.py`
- [After Effects MCP](https://github.com/mikechambers/adb-mcp/blob/main/mcp/ae-mcp.py): `mcp/ae-mcp.py`
- [Illustrator MCP](https://github.com/mikechambers/adb-mcp/blob/main/mcp/ai-mcp.py): `mcp/ai-mcp.py`
- [Photoshop batch](https://github.com/mikechambers/adb-mcp/blob/main/mcp/ps-batch-play.py): `mcp/ps-batch-play.py`

### Socket bridge

- [Command proxy](https://github.com/mikechambers/adb-mcp/blob/main/adb-proxy-socket/proxy.js): `adb-proxy-socket/proxy.js`

### UXP plugins

- [Photoshop plugin](https://github.com/mikechambers/adb-mcp/blob/main/uxp/ps/main.js): `uxp/ps/main.js`
- [Photoshop commands](https://github.com/mikechambers/adb-mcp/blob/main/uxp/ps/commands/layers.js): `uxp/ps/commands/layers.js`
- [Premiere plugin](https://github.com/mikechambers/adb-mcp/blob/main/uxp/pr/main.js): `uxp/pr/main.js`
- [Premiere commands](https://github.com/mikechambers/adb-mcp/blob/main/uxp/pr/commands/core.js): `uxp/pr/commands/core.js`
- [InDesign plugin](https://github.com/mikechambers/adb-mcp/blob/main/uxp/id/main.js): `uxp/id/main.js`
- [InDesign commands](https://github.com/mikechambers/adb-mcp/blob/main/uxp/id/commands/index.js): `uxp/id/commands/index.js`

### CEP plugins

- [After Effects plugin](https://github.com/mikechambers/adb-mcp/blob/main/cep/com.mikechambers.ae/main.js): `cep/com.mikechambers.ae/main.js`
- [After Effects actions](https://github.com/mikechambers/adb-mcp/blob/main/cep/com.mikechambers.ae/commands.js): `cep/com.mikechambers.ae/commands.js`
- [Illustrator plugin](https://github.com/mikechambers/adb-mcp/blob/main/cep/com.mikechambers.ai/main.js): `cep/com.mikechambers.ai/main.js`
- [Illustrator actions](https://github.com/mikechambers/adb-mcp/blob/main/cep/com.mikechambers.ai/commands.js): `cep/com.mikechambers.ai/commands.js`

### Shared MCP support

- [Command core](https://github.com/mikechambers/adb-mcp/blob/main/mcp/core.py): `mcp/core.py`
- [Socket client](https://github.com/mikechambers/adb-mcp/blob/main/mcp/socket_client.py): `mcp/socket_client.py`
- [Font utilities](https://github.com/mikechambers/adb-mcp/blob/main/mcp/fonts.py): `mcp/fonts.py`
- [Logger](https://github.com/mikechambers/adb-mcp/blob/main/mcp/logger.py): `mcp/logger.py`

### Other components

- **AI client**
- **Adobe applications**

## Connections

- AI client → Photoshop MCP: requests tools
- AI client → Premiere MCP: requests tools
- Photoshop MCP → Command core: uses commands (evidence: `mcp/ps-mcp.py`)
- Premiere MCP → Command core: uses commands (evidence: `mcp/pr-mcp.py`)
- InDesign MCP → Command core: uses commands (evidence: `mcp/id-mcp.py`)
- After Effects MCP → Command core: uses commands (evidence: `mcp/ae-mcp.py`)
- Illustrator MCP → Command core: uses commands (evidence: `mcp/ai-mcp.py`)
- Photoshop batch → Command core: uses commands (evidence: `mcp/ps-batch-play.py`)
- Command core → Socket client: sends commands (evidence: `mcp/core.py`)
- Socket client → Command proxy: sends packets
- Command proxy → Photoshop plugin: routes packets
- Command proxy → Premiere plugin: routes packets
- Command proxy → InDesign plugin: routes packets
- Command proxy → After Effects plugin: routes packets
- Command proxy → Illustrator plugin: routes packets
- Photoshop plugin → Photoshop commands: routes commands (evidence: `uxp/ps/main.js`)
- Premiere plugin → Premiere commands: routes commands (evidence: `uxp/pr/main.js`)
- InDesign plugin → InDesign commands: routes commands (evidence: `uxp/id/main.js`)
- After Effects plugin → After Effects actions: dispatches actions
- Illustrator plugin → Illustrator actions: dispatches actions
- Photoshop plugin → Adobe applications: controls app
- Premiere plugin → Adobe applications: controls app
- InDesign plugin → Adobe applications: controls app
- After Effects plugin → Adobe applications: controls app
- Illustrator plugin → Adobe applications: controls app
- Socket client → Logger: logs events (evidence: `mcp/socket_client.py`)
