PkgFoundry
Catalog npm
PACKAGE EXPLORERView in registry

00bx-photoshop-mcp

npm

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

adobeaiautomationbatchplaycreativedesignfireflygraphicsimage-editingmcpopencodephotoshop
Versions collected7
Direct dependencies0From release 1.1.2
Last observed20 Oct, 16:33 UTC

README

Current package documentation

00bx-photoshop-mcp

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

CategoryExamples
FiltersGaussian blur, motion blur, oil paint, sharpen, noise, pixelate, distortion
Layer stylesDrop shadow, inner glow, bevel, gradient overlay, stroke
ShapesRectangle, ellipse, polygon, line, arrow, custom path
SelectionsSubject, sky, color range, focus area, expand, feather
TextSingle/multi-line, edit properties
TransformsScale, rotate, flip, perspective, warp, content-aware scale
AdjustmentsBrightness, hue/sat, curves, levels, color balance, vibrance
CanvasCreate, crop, resize, rotate, trim
LayersCreate, duplicate, delete, group, merge, visibility, position
batchPlayExecute any Photoshop command directly

7 AI Skills (auto-installed)

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

SkillWhat it covers
ps-fundamentalsCore rules, coordinate system, masks, smart objects
ps-blend-modesAll blend mode formulas and quick reference
ps-tool-catalogComplete 323-tool reference by category
ps-batchplayBatchPlay descriptors, reference forms, event codes
ps-text-effects19 verified text effect recipes with exact parameters
ps-photo-effects13 photo effects + 4 color grading recipes
ps-advancedFilter 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

Downloads & popularity

Awaiting observations

No metric observations yet

Download counts and popularity will appear here as the collector receives them.

Versions 7

Collected releases
VersionPublishedDirect dependenciesOpen version
1.1.2Registry latest11 Feb 20260
1.1.111 Feb 20260
1.1.010 Feb 20260
1.0.310 Feb 20260
1.0.210 Feb 20260
1.0.110 Feb 20260
1.0.010 Feb 20260
Sorted by available source dates · UTC

Package advisories

0
No matching advisories collected

This describes our collected data; it is not a security assessment.

Repository

PENDING
00bx/00bx-photoshop-mcp

Shared repository data · GitHub

License detected in repository
Not collected

Metadata history

Meaningful changes
Current collected state Current

Observed since 20 Oct, 16:33 UTC

No superseded metadata states collected. Unchanged observations do not create new revisions.

Record identity

package:fe93f540ca86b48910e15400c25f7bd7266e3927b1721314db45684a59034748