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