# dcc-mcp-photoshop

> Photoshop MCP adapter backed by the adobepy broker and UXP bridge.

## Runtime chain

```
MCP client -> dcc-mcp gateway (:9765) -> Photoshop adapter
           -> adobepy broker (:47391) -> loaded UXP bridge -> Photoshop
```

## Quick start

```powershell
# 1. Start the broker from an adobepy release bundle.
adobepy broker

# 2. Generate the bridge files.
adobepy install-bridge photoshop --dest ./adobepy-photoshop-bridge

# 3. Enable Photoshop Developer Mode. In Adobe UXP Developer Tool, add
#    ./adobepy-photoshop-bridge/manifest.json and click Load.

# 4. Start the adapter.
dcc-mcp-photoshop --mcp-port 8765 --gateway-port 9765
```

The broker health endpoint must report at least one session before Photoshop
tools can work. A listening port alone is not sufficient; run a typed host tool
such as `get_document_info` as the final health check.

## Agent workflow

```
search_skills("photoshop")
load_skill("photoshop-setup")
verify_connection
load_skill("photoshop-document")
get_document_info
load_skill("photoshop-layers")
create_layer / set_layer_opacity / ...
```

## CLI options

| Flag | Default | Description |
|------|---------|-------------|
| `--mcp-port` | 8765 | Direct MCP HTTP port |
| `--broker-url` | http://127.0.0.1:47391 | adobepy broker endpoint |
| `--gateway-port` | disabled unless configured | Gateway competition port |
| `--server-name` | photoshop-mcp | MCP server name |
| `--skill-paths` | [] | Extra skill directories |
| `--no-builtins` | false | Skip built-in skills |
| `--verbose/-v` | false | Enable debug logging |

## Built-in skills

- `photoshop-setup`: stage the bridge, start the adapter, configure clients,
  and verify MCP + broker + bridge + real host execution.
- `photoshop-document`: inspect the active document and layers.
- `photoshop-image`: create, save, resize, flatten, merge, and export.
- `photoshop-layers`: create, delete, duplicate, rename, fill, show, and style layers.
- `photoshop-text`: create, update, and inspect text layers.

## Dependencies and distribution

- `dcc-mcp-core>=0.19.17,<1.0.0`
- `adobepy>=0.1.0`
- Python >=3.8
- Photoshop 2025+ for the current adobepy bridge manifest
- Adapter: PyPI or standalone binary from dcc-mcp-photoshop releases
- Broker and UXP bridge template: adobepy release bundle
