photoshop-mcp

Photoshop MCP

Idiomas: English · 简体中文 · Español · Deutsch · 日本語 · Türkçe · Sitio web

Chatea con Photoshop como con un colega. Describe lo que quieras en palabras sencillas: "quita este fondo", "redimensiona estos para Instagram" — y tu asistente de IA hace los clics por ti. Funciona con Cursor, Claude o la ventana de chat integrada. Sin código, sin scripts, sin necesidad de IDE.

Nota: Este es un proyecto no oficial, mantenido por la comunidad, y no está afiliado ni respaldado por Adobe Inc.

Nuevo: ediciones instantáneas con Jev

No todas las indicaciones necesitan un modelo de lenguaje. La ventana de chat integrada ahora puede preguntar a Jev, el modelo System One de TypeSafe AI, a dónde debe ir cada mensaje antes de que se ejecute cualquier LLM. Cuando Jev está seguro de que pediste uno de los 26 comandos y recetas seguros (deshacer, opacidad, modo de fusión, quitar fondo, corrección de color, carrusel dividido, …), o una cadena corta de ellos como "blanco y negro, luego opacidad 50", se ejecuta en Photoshop de inmediato: sin llamada al LLM, sin tokens de LLM. Cualquier otra cosa, y los pasos difíciles de deshacer como fusionar o aplanar, van al Plan de acción.

TYPESAFE_API_KEY=... npx -p @alisaitteke/photoshop-mcp ui

Experimental y opcional. Sin la clave, la interfaz funciona exactamente como antes y no se envía nada a TypeSafe; con ella, las indicaciones también van a api.typesafe.ai. Rutas, umbrales y el interruptor de apagado: docs/standalone-ui.md.

¿Qué puede hacer?

• ✂️ Quitar fondos — sujeto aislado con una máscara limpia y editable
• 👤 Retocar retratos — suavizado de piel, corrección de tonos, configuración de sobreexponer y subexponer
• 🌐 Exportar para web y redes sociales — sRGB, nitidez, tamaño correcto para Instagram, X y más
• 🎞️ Crear carruseles — divide un diseño ancho en diapositivas numeradas y sin fisuras
• 💧 Marca de agua en lote — una carpeta completa de fotos de una vez, originales intactos
• 🎨 Corrección de color y más — looks de cine, reemplazo de cielo, relleno generativo (requiere cuenta de Adobe)
• ⏪ Mantente seguro — cada "receta" de varios pasos es un solo paso de deshacer en Photoshop

Bajo el capó: 127 herramientas (111 atómicas + 16 recetas de un paso) — lista completa en docs/available-tools.md.

Prueba a decir

Remove the background from this portrait — keep it editable with a mask.

Enhance this portrait — smooth the skin and fix the tones, medium intensity.

Prepare this design for web, then export Instagram and X post variants.

Split this wide banner into a 5-slide seamless Instagram carousel.

Más recetas (marca de agua en lote, fotos de pasaporte, tarjetas impulsadas por CSV, maquetas, …) y plantillas de indicaciones predefinidas: docs/prompt-layer.md.

Comenzar

Necesitas Photoshop en ejecución (Windows o macOS, cualquier versión 2012+) y Node.js 18+.

Opción 1 — La más fácil: la ventana de chat integrada

npx -p @alisaitteke/photoshop-mcp ui

Se abre una ventana de chat en tu navegador. Inicia sesión con una clave de API de proveedor de IA — o reutiliza tu cuenta existente de Claude Code / Gemini CLI, sin necesidad de clave.

Detalles, proveedores, Plan de acción (clave de API o cuenta CLI) y notas de seguridad: docs/standalone-ui.md.

Opción 2 — Dentro de tu aplicación de IA (Cursor, Claude, VS Code)

Cursor (muestra el logotipo de Photoshop en la lista de MCP): instala el plugin desde Personalizar → Plugins, o busca en el Cursor Marketplace por photoshop-mcp una vez que esté listado. Ese paquete aún lanza npx -y @alisaitteke/photoshop-mcp; el manifiesto del plugin es lo que proporciona el icono.

Hasta que el listado del Marketplace esté disponible, copia .cursor-plugin/, mcp.json y assets/ en ~/.cursor/plugins/local/photoshop-mcp y recarga la ventana — detalles en CONTRIBUTING.md. El botón Instalar en Cursor y una entrada cruda de mcp.json todavía funcionan, pero muestran un icono genérico.

Claude Code:

claude mcp add photoshop -- npx -y @alisaitteke/photoshop-mcp

O añade esto a la configuración de tu cliente MCP (Cursor, Claude Desktop, …):

{
  "mcpServers": {
    "photoshop": {
      "command": "npx",
      "args": ["-y", "@alisaitteke/photoshop-mcp"]
    }
  }
}

Cómo funciona

1. Escribes lo que quieres en lenguaje sencillo.
2. La IA planifica los pasos, comprobando primero el estado del documento.
3. Photoshop ejecuta — cada receta aterriza como un paso deshacible.

¿Algo salió mal? La IA lee el error estructurado y sabe qué intentar a continuación. Correcciones comunes: docs/troubleshooting.md.

Documentación

• Herramientas disponibles — las 127 herramientas con parámetros
• Interfaz independiente — proveedores, modos de autenticación, Plan de acción, seguridad
• Capa de indicaciones — plantillas de indicaciones y recetas
• Arquitectura — cómo funciona el puente bajo el capó
• Desarrollo — compilar desde el código fuente, pruebas

Contribuciones

¡Las contribuciones son bienvenidas! Por favor, lee CONTRIBUTING.md antes de abrir un PR.

❤️ Colaboradores y créditos

¡Gracias a todos nuestros colaboradores!

Mantenedor

Creado por Ali Sait Teke — GitHub · LinkedIn.

Licencia

MIT

Se recopilan análisis de uso anónimos y agregados de forma predeterminada y se pueden desactivar en cualquier momento — detalles en docs/anonymous-usage-analytics.md.