Photoshop MCP Server, publicado por loonghao, conecta asistentes IA con Adobe Photoshop mediante photoshop-python-api y el Model Context Protocol. El repositorio loonghao/photoshop-python-api-mcp-server lo presenta como un puente para crear, abrir y guardar documentos Photoshop, manipular capas, leer el estado de sesión y aplicar efectos o ajustes. En la verificación de GitHub del 26 de agosto de 2026, el repositorio tenía licencia MIT, 299 estrellas y 27 forks, y pyproject.toml indicaba photoshop-mcp-server 0.1.11 con Python >=3.10,<3.15.
Para Educasium, Photoshop MCP se trata como automatización local, no como generador de imágenes. Su restricción más importante aparece explícita en el README: Windows only. El servidor depende de interfaces COM de Windows para comunicarse con Photoshop, y macOS o Linux no están soportados.
Índice
- Qué hace Photoshop MCP
- Requisitos Windows, Photoshop y Python
- Configuración MCP y ciclo de vida
- Recursos y herramientas disponibles
- Seguridad, archivos y límites
- Comparación con ComfyUI MCP
- Posición de Educasium
Qué hace Photoshop MCP
Resumen: Photoshop MCP automatiza Photoshop instalado localmente en Windows mediante COM, en vez de manipular una imagen aislada. El asistente actúa dentro de una aplicación gráfica real, con documentos y capas.
Funciones principales
El README indica que el servidor puede crear, abrir y guardar documentos Photoshop, crear y manipular capas de texto o color sólido, recuperar información de sesión, documentos activos, selección, y aplicar efectos o ajustes.
Esta superficie sirve para tareas repetitivas: preparar documento, añadir texto, inspeccionar número de capas, crear composición simple, aplicar ajuste o guardar versión. Es menos adecuada para generación creativa pura, que corresponde más a ComfyUI MCP o una herramienta generativa.
Implicaciones
El servidor controla Photoshop, así que el estado de la aplicación importa. Documento activo, capa seleccionada, versión Photoshop, permisos de archivos y ruta de guardado pueden cambiar el resultado. Un asistente que dice haber creado una capa debe ser verificado en Photoshop o mediante recursos expuestos.
El reflejo Educasium es verificar estado de sesión antes y después de cada acción. En herramientas Adobe, una automatización puede ser técnicamente correcta y visualmente mediocre.
Requisitos Windows, Photoshop y Python
Resumen: el README dice claramente que el proyecto funciona solo en Windows por las interfaces COM. Photoshop debe estar instalado localmente.
Sistema y software
Los requisitos indican Windows OS only, Adobe Photoshop instalado y Python 3.10 o superior. README menciona pruebas con Photoshop CC2017 a 2024. pyproject.toml precisa Python >=3.10,<3.15, mcp ^1.6.0, photoshop-python-api ^0.24.0, loguru y tenacity.
Esta restricción excluye muchos entornos de agencia o escuela en macOS. Para esas máquinas, no conviene prometer un atajo simple. El contexto objetivo es un puesto Windows con Photoshop instalado.
Versión Photoshop
La variable PS_VERSION indica al servidor qué versión de Photoshop usar, por ejemplo 2024, 2023 o 2022. Es un detalle práctico importante: si coexisten varias versiones o la declarada no coincide, el puente puede fallar.
Una integración seria documenta Windows, Python, versión Photoshop, versión del paquete, cliente MCP y archivo de configuración usado. Ese registro evita confundir error de modelo con error de entorno.
Configuración MCP y ciclo de vida
Resumen: la configuración recomendada usa uvx con photoshop-mcp-server y PS_VERSION. El ciclo depende de Photoshop local y del cliente MCP.
Configuración estándar
README da una configuración MCP con command uvx, args --python 3.10 photoshop-mcp-server y env PS_VERSION. Indica que funciona con Claude Desktop, Windsurf, Cline y otros hosts MCP.
La instalación puede hacerse con pip install photoshop-mcp-server o uv. El script de consola en pyproject.toml es photoshop-mcp-server, apuntando a photoshop_mcp_server.server:main.
Ciclo aplicativo
El cliente MCP lanza servidor, el servidor usa Python, Python llama photoshop-python-api y Photoshop responde por COM. Si Photoshop está cerrado, bloqueado por un diálogo, o COM no encuentra la versión correcta, el asistente falla aunque la configuración MCP parezca correcta.
La primera prueba debe ser simple: pedir información Photoshop, crear documento mínimo, añadir capa texto, leer lista de capas y guardar en carpeta de test. Los documentos cliente llegan después.
Recursos y herramientas disponibles
Resumen: README expone tres recursos y familias de herramientas para documentos, capas y sesión. La superficie es más modesta que ComfyUI MCP, pero enfocada en Photoshop.
Recursos
Los recursos documentados son photoshop://info para información de aplicación, photoshop://document/info para documento activo y photoshop://document/layers para capas. Sirven antes de actuar porque dan estado inicial.
En un flujo prudente, el asistente lee recursos, confirma documento activo y lista capas. Solo después crea o modifica. Esta secuencia reduce errores de documento o capa incorrecta.
Herramientas
README agrupa herramientas en Document Tools, Layer Tools y Session Tools. Los ejemplos muestran crear documento, añadir capa texto Hello World, abrir PSD y contar capas, o crear un post social con fondo degradado y texto.
Son ejemplos útiles, pero pedagógicos. Un post profesional requiere tipografía, marca, export, dimensiones, márgenes, contraste y revisión. El MCP automatiza estructura; no garantiza criterio visual.
Seguridad, archivos y límites
Resumen: Photoshop MCP puede abrir y guardar archivos locales, así que rutas y copias son centrales. El riesgo principal es alterar un PSD de trabajo sin control.
Archivos y documentos
Crear, abrir y guardar documentos es potente. Puede sobrescribir archivos si el flujo está mal definido. Hay que usar carpeta de salida dedicada, nombrar versiones y trabajar sobre copias antes de tocar un archivo cliente.
El servidor lee estado Photoshop pero no reemplaza inspección visual. Las capas pueden existir y estar mal colocadas, mal nombradas o fuera de marca. El control visual sigue siendo obligatorio.
Límites de plataforma
La limitación Windows only no debe minimizarse. COM es específico de Windows. Para macOS y Linux se necesita otra cadena. Para renders generativos o workflows IA, ComfyUI MCP es más portable.
Las versiones Photoshop probadas van de CC2017 a 2024, pero una instalación real puede tener plugins, políticas IT, permisos o diálogos modales que cambian el comportamiento.
Comparación con ComfyUI MCP
Resumen: Photoshop MCP automatiza una aplicación Adobe local; ComfyUI MCP orquesta grafos de generación IA.
| Necesidad | Photoshop MCP | ComfyUI MCP |
|---|---|---|
| Abrir y guardar PSD | Muy adecuado | Fuera de alcance |
| Manipular capas Photoshop | Muy adecuado | Fuera de alcance |
| Generar imágenes con modelos IA | Indirecto | Muy adecuado |
| Funcionar en macOS/Linux | No | Sí según README |
| Control creativo final | Photoshop local | Grafo ComfyUI y salidas |
Cadena combinada
Un flujo coherente genera assets en ComfyUI y los finaliza en Photoshop. ComfyUI produce variantes, texturas o imágenes base. Photoshop ensambla, retoca, añade texto, prepara export y respeta marca.
Este reparto evita pedir a Photoshop MCP generación IA avanzada y a ComfyUI MCP gestión de PSD.
Posición de Educasium
Resumen: Educasium presenta Photoshop MCP como automatización de producción gráfica Windows, con validación visual obligatoria.
Qué enseñar
Un ejercicio útil empieza con PSD de test. El asistente lee recursos, lista capas, añade texto, crea color de fondo, guarda copia y el usuario verifica en Photoshop.
La competencia es controlar estado: qué documento está abierto, qué capa está activa, qué archivo se guarda y qué versión Photoshop responde. Sin esta disciplina, la automatización gráfica es frágil.
El control final incluye tamaño del documento, perfil de color, márgenes, legibilidad del texto, contraste, nombre de capas y formato de exportación. También conviene verificar que la copia guardada no sobrescribe el PSD fuente y que el destino pertenece al proyecto correcto. Estos detalles parecen ordinarios, pero separan una acción Photoshop ejecutada de un entregable realmente usable. El servidor acelera manipulación; la validación sigue siendo visual y profesional. En un contexto de formación, el alumno debe aprender a leer el estado antes de pedir cambios grandes, porque muchas fallas vienen de trabajar sobre el documento equivocado o sobre una capa no seleccionada.
También hay que enseñar el límite creativo. Un asistente puede añadir texto, generar una capa simple o guardar una versión, pero no sustituye dirección artística, guía de marca, derechos de imagen ni revisión final. En un flujo profesional, Photoshop MCP se evalúa por ahorro de tiempo en operaciones repetitivas, no por promesa de diseño autónomo. La buena práctica consiste en conservar PSD fuente, guardar variantes fechadas, revisar exports y documentar qué acciones fueron automáticas.
El cierre del ejercicio debe incluir comparación con el brief inicial. Si las capas existen pero el texto es ilegible, la automatización no está terminada. Si el archivo correcto se guarda en carpeta equivocada, tampoco. El alumno aprende a validar resultado, ruta, versión y calidad visual juntos.