Photoshop MCP Server

Un servidor de Model Context Protocol (MCP) que permite a los asistentes de IA (Claude, opencode, Cursor, etc.) controlar Adobe Photoshop en Windows mediante automatización de ExtendScript + COM.

Diseñado para Photoshop 2020 (v21.x) pero compatible con versiones más recientes. ~122 herramientas que cubren documentos, capas, texto, filtros, ajustes de color, selecciones y máscaras, estilos de capa, exportación, análisis de diseño, control de calidad de diseño e introspección del estado de Photoshop.

Proyecto comunitario no oficial. No afiliado ni respaldado por Adobe.

Cómo funciona

MCP client (opencode/Claude) 
   → Node MCP server (server.js, stdio)
   → bridge.ps1 (PowerShell)
   → Photoshop COM (Application.DoJavaScriptFile)
   → ExtendScript DOM

• ExtendScript, no UXP — la automatización externa a través de COM solo puede usar ExtendScript, que funciona en todas las versiones de Photoshop (2012–2025+). UXP es para complementos en proceso y no se puede invocar externamente.

• Seguro para Unicode — el texto no ASCII (p. ej. £, —) se escapa a \uXXXX en el JSX generado y se antepone un BOM UTF-8, de modo que los precios/acentos se conservan correctamente.

• Reintento en caso de ocupado — los errores transitorios de COM RPC_E_SERVERCALL_RETRYLATER ("la aplicación está ocupada") se reintentan con retroceso.

Related MCP server: ImageMcp

Requisitos

• Windows

• Adobe Photoshop instalado (probado en PS 2020 / v21.2)

• Node.js 18+

Instalación

npm install

Configurar como servidor MCP

Añádelo a la configuración de tu cliente MCP (p. ej. ~/.config/opencode/opencode.jsonc, Claude Desktop, Cursor):

{
  "mcpServers": {
    "photoshop": {
      "command": "node",
      "args": ["C:\\path\\to\\photoshop-mcp\\server.js"]
    }
  }
}

Reinicia tu cliente MCP después de los cambios para que se cargue la lista de herramientas actualizada.

Herramientas destacadas

Ejecuta tools/list en tu cliente MCP para ver las ~122 herramientas.

Referencia de configuración

Limitaciones conocidas

• IA generativa (Firefly) y Filtros neuronales requieren PS 24+ / un complemento puente UXP y no se pueden controlar mediante ExtendScript.

• select_subject necesita PS 23+. export_as WebP/AVIF necesita PS 23.2+.

• En PS 2020, algunos comandos muestran un aviso de "Photoshop está ocupado" si hay un diálogo modal abierto: ciérralo y vuelve a intentarlo.

Créditos

Diseño de capacidades inspirado en:

• alisaitteke/photoshop-mcp

• loonghao/photoshop-python-api-mcp-server

Ambos tienen licencia MIT. Este proyecto es una implementación independiente con herramientas adicionales (análisis de diseño, control de calidad de diseño, sistemas de diseño, regresión visual).

Licencia

MIT