00bx-photoshop-mcp

MCP server for Adobe Photoshop. 323 tools + 7 AI skills for design automation via OpenCode.

Install

npm install -g 00bx-photoshop-mcp
00bx-photoshop-mcp-install

Installs everything to ~/.00bx-photoshop-mcp/ and 7 OpenCode skills to ~/.config/opencode/skills/.

Setup

1. Start the proxy

cd ~/.00bx-photoshop-mcp/adb-proxy-socket && node proxy.js

Keep this running. Background alternative:

nohup node proxy.js > /tmp/ps-proxy.log 2>&1 &

2. Load the UXP plugin

1. Open Adobe UXP Developer Tool (from Creative Cloud)
2. Add Plugin -> select ~/.00bx-photoshop-mcp/uxp/ps
3. Click Load
4. Open Photoshop

3. Add MCP config

Add to ~/.config/opencode/opencode.json:

{
  "mcp": {
    "adobe-photoshop": {
      "type": "local",
      "command": [
        "~/.00bx-photoshop-mcp/mcp/.venv/bin/python",
        "~/.00bx-photoshop-mcp/mcp/ps-mcp.py"
      ],
      "timeout": 30000,
      "enabled": true
    }
  }
}

Restart OpenCode. Done.

What's included

323 Tools

| Category | Examples | | ------------ | --------------------------------------------------------------------------- | | Filters | Gaussian blur, motion blur, oil paint, sharpen, noise, pixelate, distortion | | Layer styles | Drop shadow, inner glow, bevel, gradient overlay, stroke | | Shapes | Rectangle, ellipse, polygon, line, arrow, custom path | | Selections | Subject, sky, color range, focus area, expand, feather | | Text | Single/multi-line, edit properties | | Transforms | Scale, rotate, flip, perspective, warp, content-aware scale | | Adjustments | Brightness, hue/sat, curves, levels, color balance, vibrance | | Canvas | Create, crop, resize, rotate, trim | | Layers | Create, duplicate, delete, group, merge, visibility, position | | batchPlay | Execute any Photoshop command directly |

7 AI Skills (auto-installed)

Skills load on-demand so they don't eat your context window.

| Skill | What it covers | | ------------------ | ------------------------------------------------------------- | | ps-fundamentals | Core rules, coordinate system, masks, smart objects | | ps-blend-modes | All blend mode formulas and quick reference | | ps-tool-catalog | Complete 323-tool reference by category | | ps-batchplay | BatchPlay descriptors, reference forms, event codes | | ps-text-effects | 19 verified text effect recipes with exact parameters | | ps-photo-effects | 13 photo effects + 4 color grading recipes | | ps-advanced | Filter ranges, workflow templates, gotchas, quality checklist |

Architecture

OpenCode <-> MCP Server (Python) <-> Proxy (Node) <-> UXP Plugin <-> Photoshop

Requirements

• Adobe Photoshop 2025/2026
• Adobe UXP Developer Tool
• Python 3.10+
• Node.js 18+
• OpenCode

Troubleshooting

"Could not connect to photoshop"

• Check proxy is running: lsof -i :3001
• Check UXP plugin is loaded
• Make sure Photoshop is open

MCP not showing in OpenCode

• Validate config: cat ~/.config/opencode/opencode.json | python3 -m json.tool
• Restart OpenCode

Commands timeout

• Increase timeout to 60000 in your config
• Open a document in Photoshop first (some commands need one)

Attribution

Forked from mikechambers/adb-mcp. Extended from 50 to 323 tools with full filter/effect coverage.

License

MIT