@synthetic-ai/photoshop-mcp 1.0.0

package/README.md

@@ -0,0 +1,101 @@
+# Photoshop MCP
+
+Servidor **MCP** para controlar e inspeccionar **Adobe Photoshop** desde Claude (o cualquier
+cliente MCP), al estilo de los MCPs de Synthetic (After Effects / Premiere Pro).
+
+Photoshop 2022+ ya no expone automatización COM funcional, así que el control se hace con un
+**plugin puente** que corre *dentro* de Photoshop y se conecta por **WebSocket** a este server.
+
+```
+Claude ──MCP──▶ server.mjs ──WebSocket(127.0.0.1:41219)──▶ plugin puente ──▶ Photoshop
+```
+
+Producto **pago** (licencia mensual/anual, igual estructura que After Effects MCP). El server exige
+una licencia válida (`PS_MCP_LICENSE`) para todas las tools excepto `ps_healthcheck` / `ps_info` /
+`ps_help`. Conseguí una licencia en https://synthetic.com.ar/photoshop-mcp.
+
+## Componentes
+
+- **`server.mjs`** — server MCP (Node, `@modelcontextprotocol/sdk` + `ws`). Expone las tools.
+- **`bridge-cep/`** — plugin puente **CEP** (HTML/JS + ExtendScript). Se instala sin herramientas
+  extra (copiar a la carpeta de extensiones CEP + `PlayerDebugMode=1`). **Es el que está probado.**
+- **`bridge-uxp/`** — plugin puente **UXP** (alternativa moderna; requiere UXP Developer Tools).
+
+## Convención de tools (estilo Synthetic)
+
+- **Diagnóstico/app:** `ps_healthcheck`, `ps_info`, `ps_help`
+- **Escape hatches:** `run_jsx`, `run_jsx_json`, `run_action`
+- **Dominio:** `snake_case` verbo_sustantivo, sin prefijo —
+  `list_layers`, `add_text_layer`, `set_layer_opacity`, `export_png`, `apply_gaussian_blur`,
+  `adjust_brightness_contrast`, `select_rectangle`, `add_layer_mask`…
+
+Dominios cubiertos: documentos, capas, texto, color, selección, máscaras, transform, filtros,
+ajustes, efectos de capa, smart objects, guías, acciones, export. `ps_help` devuelve el catálogo
+completo. Para cualquier cosa no nombrada todavía: `run_jsx` (ExtendScript) o `run_action`
+(Action Manager).
+
+## Instalación
+
+### 1) Server
+```
+npm install
+```
+
+### 2) Plugin puente (CEP — recomendado, sin herramientas extra)
+
+**Opción A — instalador firmado (.zxp), para clientes finales:**
+Bajá el `.zxp` desde https://synthetic.com.ar/dashboard/downloads (necesita licencia activa),
+abrilo con [ZXP Installer](https://aescripts.com/learn/zxp-installer/) y reiniciá Photoshop.
+
+**Opción B — desde el código fuente, para desarrollo:**
+1. Copiar `bridge-cep/` a `%APPDATA%\Adobe\CEP\extensions\com.matias.psmcpbridge\`.
+2. Habilitar extensiones sin firma: en `HKCU\Software\Adobe\CSXS.N\PlayerDebugMode = "1"`
+   (para N = 9..12, según versión de Photoshop). *(Reversible.)*
+3. Reiniciar Photoshop → **Ventana ▸ Extensiones (heredadas) ▸ PS-MCP Bridge**.
+4. El panel se conecta solo al server (reintenta cada 3s); debe decir **«Conectado»**.
+
+### 3) Licencia del panel
+
+El panel necesita tu licencia para bajar actualizaciones (auto-update). Abrí el panel dentro de
+Photoshop, clic en **⚙ (Settings)**, pegá tu clave de licencia y **Save license** — queda guardada
+localmente junto a la extensión (`license.json`), no depende de variables de entorno del proceso
+de Photoshop.
+
+### 4) Registrar el MCP en el cliente
+```
+claude mcp add photoshop -- node "RUTA/server.mjs"
+```
+Y agregá tu licencia al bloque `env` de esa entrada en la config del cliente MCP (Claude Desktop /
+Cursor / Codex):
+```json
+"env": { "PS_MCP_LICENSE": "tu-clave-de-licencia" }
+```
+Sin esta variable, el server responde `License required` en todas las tools excepto
+`ps_healthcheck` / `ps_info` / `ps_help`.
+
+## Uso
+
+1. Tener Photoshop abierto con el panel **PS-MCP Bridge** conectado.
+2. Arrancar el server (lo hace el cliente MCP al registrarlo).
+3. `ps_healthcheck` para confirmar; `ps_help` para ver todas las tools.
+
+Las tools de export (`export_png`, `export_layer_png`, `export_jpg`) guardan a disco y devuelven
+la ruta, para inspección visual.
+
+## Build del panel (.zxp)
+
+```
+ZXP_SIGN_CMD="/ruta/a/ZXPSignCmd.exe" npm run package-cep
+```
+Empaqueta `bridge-cep/`, estampa la versión de `package.json` en `CSXS/manifest.xml` y en la
+constante `PANEL_VERSION` de `main.js`, ofusca `main.js` (no `host.jsx` — corre en el motor
+ExtendScript de Photoshop, no en Chromium, y el código ofuscado puede fallar ahí) y firma el
+`.zxp` resultante. Ver `scripts/package-cep.mjs` para el detalle completo del pipeline.
+
+## Notas
+
+- Puerto configurable con `PS_MCP_PORT` (default 41219). Si lo cambiás, ajustá `PORT` en el
+  `main.js` del bridge y los `domains` del manifest UXP.
+- Windows/macOS con Photoshop 2022+.
+- El panel chequea actualizaciones al abrir y ofrece aplicarlas en un click (in-panel auto-update),
+  igual que el resto de los paneles CEP de Synthetic.

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@synthetic-ai/photoshop-mcp",
+  "version": "1.0.0",
+  "type": "module",
+  "description": "Control Adobe Photoshop with 409 AI tools via MCP — layers, text, masks, filters, adjustments, smart objects, export. By Synthetic (synthetic.com.ar).",
+  "homepage": "https://synthetic.com.ar/photoshop-mcp",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/matiasEltrece/photoshop-mcp"
+  },
+  "author": "Synthetic <hola@synthetic.com.ar> (https://synthetic.com.ar)",
+  "license": "UNLICENSED",
+  "keywords": [
+    "mcp",
+    "photoshop",
+    "adobe",
+    "model-context-protocol",
+    "claude",
+    "ai",
+    "synthetic"
+  ],
+  "main": "./server.mjs",
+  "bin": {
+    "photoshop-mcp": "./server.mjs"
+  },
+  "files": [
+    "server.mjs",
+    "README.md"
+  ],
+  "scripts": {
+    "start": "node server.mjs",
+    "package-cep": "node scripts/package-cep.mjs"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.6.0",
+    "ws": "^8.18.0",
+    "zod": "^3.23.8"
+  },
+  "devDependencies": {
+    "javascript-obfuscator": "^4.1.1"
+  }
+}