photoshop-mcp
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 DOMExtendScript, 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\uXXXXen 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 installConfigurar 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
Área | Herramientas |
Documentos |
|
Capas |
|
Operaciones de capa |
|
Texto |
|
Filtros |
|
Color |
|
Selecciones y máscaras |
|
Estilos de capa |
|
Historial |
|
Diseño / QA |
|
Sistema de diseño |
|
Introspección |
|
Basado en datos |
|
Automatización |
|
Ejecuta tools/list en tu cliente MCP para ver las ~122 herramientas.
Referencia de configuración
| Archivos JSX temporales (creados automáticamente) |
| Capturas PNG con nombre para regresión visual ( |
| Copias de seguridad PSD para revertir ( |
| Sistemas de diseño guardados ( |
Limitaciones conocidas
IA generativa (Firefly) y Filtros neuronales requieren PS 24+ / un complemento puente UXP y no se pueden controlar mediante ExtendScript.
select_subjectnecesita PS 23+.export_asWebP/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:
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
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Hosted MCP server for AI photo editing: nothing to install, no desktop photo editor needed.
214 tools for AI agents over one MCP endpoint: image, video, audio, 3D, data, storage, mail, GPUs.
Nifty's MCP server — exposes tasks, projects, messages, and files as tools for AI agents.
MCP server for Qwen Image 3 AI image generation
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceAn MCP server for controlling Adobe Photoshop from AI assistants, with Windows-first workflow, structured state, smoke-tested action playback, and a bundled Codex skill for image editing.5MIT
- FlicenseNot gradedqualityDmaintenanceA full-featured image processing MCP server for AI assistants, exposing ~55 tools across 11 categories for editing, layers, conversion, AI segmentation/cleanup/generation, design analysis, and screenshot-to-code.-
- AlicenseAqualityDmaintenanceA professional MCP server that lets AI assistants directly control Adobe Photoshop for document creation, layer management, filters, adjustments, shapes, text, and design intelligence like palette generation and font pairing.322MIT
- FlicenseNot gradedqualityDmaintenanceAn MCP server that lets AI assistants control Adobe Illustrator locally—running ExtendScript, capturing canvas screenshots, exporting artwork, and optionally remembering techniques—all without network activity.-