Skip to main content
Glama

Free Photoshop MCP

Pídele a tu agente de IA el diseño que quieres en Photoshop. Él lo arma, lo mira y lo corrige, con tu estilo.

by Videazo Super Intelligence

Windows Node 18+ MCP Licencia: MIT

Claude · Codex · Cursor · Gemini CLI · Windsurf

Descargar el instalador (.exe) · Página

Esta pieza la hizo un agente con este MCP: degradado, luz borrosa en screen, grano en overlay, forma con trazo y resplandor, y texto por tramos, con un estilo guardado.


Qué es

Un servidor MCP que conecta a tu agente con Adobe Photoshop. Va más allá de "poner un texto": trabaja como un diseñador.

  • Entiende el proyecto: tamaño, resolución, modo de color, profundidad, perfil ICC, guías, artboards, y qué recursos usa (fuentes instaladas o no, archivos vinculados, bibliotecas de Creative Cloud, objetos inteligentes).

  • Trabaja con todo lo avanzado: capas y grupos, texto con control tipográfico completo (tramos Light + Black en el mismo bloque, tracking, interlineado, ejes de fuentes variables), formas vectoriales, sombras apiladas, resplandores, bisel, satinado, trazos, degradados, todos los modos de fusión, relleno vs. opacidad, «Mezclar si», máscaras (de capa, de recorte, vectoriales, degradadas), capas de ajuste, filtros (también como filtros inteligentes), selecciones, objetos inteligentes, quitar fondo con IA, historial.

  • Ve lo que hace: ps_preview le devuelve la imagen para que corrija solo.

  • Aprende tu estilo: ps_style_analyze lee tus PSD terminados y extrae paleta (la real del render), tipografía por jerarquía, recetas de efectos, hábitos de mezcla/relleno, formas, estructura de capas y maquetación. Lo guarda y lo aplica con preset:'titulo' y effects:{recipe:'…'}.

  • Sin instalar nada dentro de Photoshop: se conecta por COM. Cada herramienta que cambia algo queda en un solo paso del historial (Videazo · …, Ctrl+Z).

Es gratis y de código abierto (MIT). No abre puertos de red ni envía tus archivos a ningún servidor.

Related MCP server: Photoshop MCP Server

Qué puedes pedirle

Crea un carrusel de 3 diapositivas 1:1 en un solo lienzo, fondo casi negro con luz verde,
y pon el título «EL COMBUSTIBLE PARA RESPLANDECER» con mi estilo. Mírala y corrígela.

Lee mi carrusel.psd y aprende mi estilo. Luego dime qué fuentes y efectos uso.

Dime qué recursos usa este PSD y si falta alguno (fuentes, vínculos).

Duplica este diseño a 4:5 para Instagram y exporta cada diapositiva en PNG.

Instalar (Windows)

Requisitos: Photoshop (probado en la 2026, versión 27) y un agente compatible con MCP. No necesitas instalar Node.js: el instalador lo lleva dentro.

Opción A · El instalador (.exe) · recomendada

  1. Descarga Videazo-Photoshop-MCP-Setup.exe (36 MB).

  2. Ábrelo, deja marcados los agentes que quieras conectar y pulsa Instalar. No pide administrador.

  3. Reinicia tu agente y pídele: «usa ps_status».

Windows puede mostrar «Windows protegió su PC» porque el .exe no tiene firma de pago. Pulsa Más información → Ejecutar de todos modos. El código del instalador está en installer/ y puedes compilarlo tú (node installer/build.mjs).

Se desinstala desde Configuración → Aplicaciones, o con Videazo-Photoshop-MCP-Setup.exe --uninstall. Modo sin ventana: --silent.

Opción B · Pega este prompt en tu agente

Instala Free Photoshop MCP by Videazo Super Intelligence en mi computador (Windows). Pídeme confirmación antes de instalar:
1. Comprueba que uso Windows y que tengo Photoshop.
2. Descarga solo desde este enlace: https://github.com/joshcreativos-ctrl/photoshop-mcp/releases/latest/download/Videazo-Photoshop-MCP-Setup.exe y guárdalo en una carpeta temporal.
3. Con mi sí, ejecútalo con `--silent` (instala y conecta los agentes detectados, sin administrador).
4. Dime que reinicie mi agente. Cuando vuelva, prueba con la herramienta ps_status.

Opción C · Desde el código (para desarrolladores)

Con Node.js 18+: node install.mjs (opciones: --dry-run, --uninstall, --no-claude-code, --no-claude-desktop, --no-codex, --no-cursor, --no-gemini, --no-windsurf).

El instalador copia el servidor a %LOCALAPPDATA%\Videazo\ps-mcp y lo registra como photoshop en los agentes que tengas. No toca Photoshop.

Cómo trabaja

Agente ⇄ MCP (stdio) ⇄ server.mjs ⇄ PowerShell/COM ⇄ Photoshop (ExtendScript + Action Manager)

Las operaciones se escriben una sola vez en jsx/ (biblioteca ExtendScript) y se envían con cada orden. Todo el Action Manager se serializa a JSON reversible ({_c:'clase'}, {_u:'pixelsUnit',v}, {_e:[tipo,valor]}…), por eso un estilo de capa se puede capturar y volver a aplicar exacto.

Herramientas

Grupo

Herramientas

Proyecto

ps_status ps_open ps_new_document ps_document_info ps_project_report ps_resources ps_set_document ps_create_artboard ps_save ps_close ps_export ps_history

Ver

ps_preview ps_palette ps_layers ps_layer_info ps_text_info ps_fonts

Crear

ps_add_text ps_add_shape ps_create_layer ps_place_image ps_add_adjustment ps_batch

Modificar

ps_edit_text ps_set_layer ps_layer_style ps_mask ps_filter ps_selection ps_fill ps_smart_object ps_remove_background

Organizar

ps_group ps_duplicate_layer ps_delete_layer ps_merge_rasterize ps_align

Estilo

ps_style_analyze ps_style_list ps_style_get ps_style_set ps_capture_style

Salida libre

ps_action_manager ps_execute_script ps_run_action ps_run_script_file

Aprender tu estilo

  1. ps_style_analyze con tus PSD terminados (los abre, los lee y los cierra sin guardar).

  2. Se guarda en %APPDATA%\Videazo\photoshop-mcp\styles\<nombre>.json y .md (la guía).

  3. Antes de diseñar, tu agente lee ps_style_get y sigue la guía. En las llamadas usa preset:'titulo' y effects:{recipe:'sombra-x3+resplandor-verde'}.

  4. Afina con ps_style_set (presets, colores con nombre, notas) o guarda cualquier capa que te guste con ps_capture_style name:'…'.

Solución de problemas

  • No responde: Photoshop no atiende órdenes con un cuadro de diálogo abierto. Ciérralo.

  • Fuente no encontrada: ps_fonts query:'nombre' y usa el nombre PostScript.

  • Primer uso lento: la primera llamada conecta con Photoshop (y lo abre si estaba cerrado).

  • Análisis de un PSD muy pesado: tarda más porque Photoshop debe leer cada capa; el análisis tiene un presupuesto de tiempo y avisa si se truncó.

Límites honestos

  • Solo Windows (usa COM).

  • Photoshop es de Adobe; este proyecto no está afiliado a Adobe. Los nombres se usan solo para indicar compatibilidad.

  • Funciones que dependen de servicios en la nube de Adobe (relleno generativo) no se exponen directamente; usa ps_action_manager.

Licencia

MIT.

Available Tools

47 tools
ps_action_managerAction Manager directoA

Ejecuta cualquier evento de Photoshop con un descriptor en JSON etiquetado (objeto {_c:'clase'}, unidad {_u:'pixelsUnit',v}, enum {_e:[tipo,valor]}, entero {_i}, referencia {ref:[{cls,form,...}]}). get:[referencia] lee propiedades. Es la salida para cualquier herramienta avanzada que no tenga ps* propio.

Inputs: doc, get, event, exact, +2 more.

ps_add_adjustmentCapa de ajusteB

Crea una capa de ajuste no destructiva. type y params: brightnessContrast{brightness,contrast} · levels{inBlack,inWhite,gamma,outBlack,outWhite,channel} · curves{points:[[x,y]..],channel | channels:{red,green,blue}} · hueSaturation{hue,saturation,lightness,colorize} · vibrance{vibrance,saturation} · colorBalance{shadows,midtones,highlights:[c-r,m-g,y-b]} · blackAndWhite{red,yellow,green,cyan,blue,magenta,tint} · photoFilter{color,density} · gradientMap{stops} · exposure{exposure,offset,gamma} · selectiveColor{colors:{reds:{cyan,magenta,yellow,black}}} · invert · threshold{level} · posterize{levels}. clip=true la limita a la capa de abajo.

Inputs: type (required), x, y, doc, +14 more.

ps_add_shapeAgregar formaB

Crea una forma vectorial: rectangle, roundRect (radius número, [tl,tr,br,bl] o 'pill'), ellipse, circle, polygon, star, line o path (points). Relleno sólido o degradado, trazo (ancho, alineación, guiones), efectos, mezcla y opacidad.

Inputs: x, y, x2, y2, +26 more.

ps_add_textAgregar textoA

Crea una capa de texto con control tipográfico completo. Un solo estilo con 'style', o varios tramos con 'runs' (p. ej. una línea Light y otra Black). x,y + anchor colocan el contorno visible; box={width,height} crea texto de párrafo. Admite efectos en la misma llamada.

Inputs: x, y, box, doc, +21 more.

ps_alignAlinear y distribuirC

Alinea capas al lienzo, a la primera capa, a un artboard o a un rectángulo {x,y,width,height}; distribuye en h/v con espacios iguales.

Inputs: layers (required), h, v, to, +3 more.

ps_batchVarias operaciones en unaA

Ejecuta varias herramientas en orden y las agrupa en UN solo paso del historial. Cada elemento: {tool:'add_shape'|'add_text'|'place_image'|'layer_style'|'set_layer'|'create_layer'|'add_adjustment'|'filter'|'mask'|'group'|'align'|'duplicate_layer'|'delete_layer'|'selection'|'fill', args:{...}} con los mismos parámetros que la herramienta ps_. Ideal para armar una composición completa. Se detiene en el primer error y dice cuál fue.

Inputs: steps (required), doc, name.

ps_capture_styleCapturar estilo de una capaA

Lee los efectos, mezcla, relleno y (si es texto) la tipografía de una capa como receta reutilizable. Con name la guarda en el estilo activo para usarla luego con effects:{recipe}.

Inputs: layer (required), doc, name.

ps_closeCerrar documentoB

Cierra un documento (sin guardar salvo save=true).

Inputs: doc, save.

ps_create_artboardMesa de trabajoB

Crea una mesa de trabajo (artboard) con nombre, posición y tamaño exactos, y color de fondo opcional. Útil para varias piezas (diapositivas, formatos) en un mismo documento; luego ps_export mode:"artboards" las exporta una por una.

Inputs: width (required), height (required), x, y, +3 more.

ps_create_layerCrear capa o grupoC

Crea una capa de píxeles (opcionalmente rellena), un grupo, o una capa de relleno sólido/degradado a todo el lienzo.

Inputs: x, y, doc, fill, +14 more.

ps_delete_layerBorrar capasC

Borra una o varias capas.

Inputs: doc, layer, layers.

ps_document_infoConfiguración del documentoB

Todo lo que define el proyecto: tamaño, resolución, modo, profundidad, perfil, guías, artboards, canales, trazados, composiciones, conteo de capas por tipo e historial.

Inputs: doc, raw.

ps_duplicate_layerDuplicar capaC

Duplica una capa (en el mismo documento u otro con toDocument), con nombre, desplazamiento o posición nuevos.

Inputs: layer (required), x, y, doc, +7 more.

ps_edit_textEditar textoC

Cambia el contenido y/o el estilo de una capa de texto existente (conserva lo que no indiques). También mover, rotar, efectos y mezcla.

Inputs: layer (required), x, y, box, +18 more.

ps_execute_scriptEjecutar ExtendScriptA

Ejecuta código ExtendScript (JS ES3) dentro de Photoshop con acceso total a app, documentos, capas y a las ayudas VZ/U/AM. code es el CUERPO de una función: usa return para devolver datos. Variables: A (args), U (utilidades), AM (Action Manager JSON), VZ.

Inputs: code (required), args, history, timeoutSeconds.

ps_exportExportarB

Exporta copias sin tocar el documento: todo el documento, cada artboard, cada grupo de nivel superior, o recortes (slices). Para un carrusel panorámico usa mode:'slides'.

Inputs: folder (required), doc, crop, mode, +5 more.

ps_fillRellenar píxelesC

Rellena la selección (o toda la capa) con un color, un degradado, o con relleno según contenido (contentAware).

Inputs: to, doc, from, color, +5 more.

ps_filterFiltrosA

Aplica un filtro a una capa: gaussianBlur{radius} · motionBlur{angle,distance} · radialBlur{amount,method} · addNoise/grain{amount,distribution,monochrome} · unsharpMask{amount,radius,threshold} · highPass{radius} · median{radius} · sharpen · dustAndScratches · surfaceBlur · smartSharpen · filmGrain · diffuseGlow · cameraRaw{exposure,contrast,highlights,shadows,whites,blacks,texture,clarity,dehaze,vibrance,saturation,temperature,tint,vignette,grain}. toSmart=true lo hace como filtro inteligente (editable).

Inputs: layer (required), filter (required), doc, params, +1 more.

ps_fontsBuscar fuentesA

Busca entre las fuentes instaladas (nombre PostScript, familia y estilo) para usar en ps_add_text.

Inputs: limit, query.

ps_groupAgrupar / desagruparC

Agrupa capas en un grupo (con nombre, modo de fusión, efectos) o desagrupa un grupo.

Inputs: doc, name, blend, layers, +3 more.

ps_historyHistorialB

Lista los pasos del historial, deshace/rehace (steps), vuelve a un paso (revert con index) o crea una instantánea.

Inputs: doc, name, index, steps, +1 more.

ps_layer_infoDetalle de una capaA

Todo sobre una capa: texto con cada tramo (fuente, tamaño real, tracking, interlineado, color), efectos en esquema amigable, trazo y radios de formas, máscara, objeto inteligente, mezcla. raw=true añade el descriptor completo.

Inputs: layer (required), doc, raw, exact.

ps_layersÁrbol de capasB

Lista las capas con tipo, visibilidad, opacidad, relleno, modo de fusión, contorno, máscaras, efectos activos, texto y objetos inteligentes (vinculado/incrustado). depth limita los niveles; group baja a un grupo.

Inputs: doc, raw, depth, group, +1 more.

ps_layer_styleEfectos de capaA

Aplica estilos de capa: sombras (varias apiladas), sombra interior, resplandores, bisel y relieve, satinado, superposición de color/degradado, trazo. mode:'replace' (por defecto) reemplaza los efectos; 'merge' conserva los demás. copyFrom copia los efectos de otra capa. Devuelve los efectos resultantes leídos de Photoshop.

Inputs: layer (required), doc, mode, disable, +2 more.

ps_maskMáscarasB

Máscaras de capa: revealAll, hideAll, rect/ellipse (con radius y feather), selection (usa la selección actual), gradient (desvanecido lineal o radial, direction: up/down/left/right/radial), delete, apply, clip/unclip (máscara de recorte). density y maskFeather ajustan la máscara.

Inputs: layer (required), doc, end, rect, +8 more.

ps_merge_rasterizeCombinar / rasterizarC

Combina capas (merge), crea una capa de sello con todo lo visible (mode:'stamp'), o rasteriza (what: layer|style|text|shape).

Inputs: doc, mode, name, layer, +2 more.

ps_new_documentDocumento nuevoB

Crea un documento con toda su configuración: tamaño, unidad, resolución, modo de color, profundidad, perfil ICC, fondo, guías y, para carruseles, diapositivas continuas (slides: {count, width}) con guías en cada corte.

Inputs: width (required), height (required), mode, name, +7 more.

ps_openAbrir archivoC

Abre un PSD/PSB/imagen/PDF/AI en Photoshop y devuelve su configuración.

Inputs: path (required), page, resolution.

ps_palettePaleta del renderA

Calcula los colores dominantes de lo que se VE en el documento (no solo de las capas), con porcentaje.

Inputs: doc, colors.

ps_place_imageColocar imagenB

Coloca un archivo como objeto inteligente (incrustado o vinculado). Con box={x,y,width,height} y fit ('cover' recorta con máscara, 'contain', 'stretch') la encaja en un marco; radius redondea el marco. También escala/posición libres.

Inputs: x, y, box, doc, +23 more.

ps_previewVer el diseñoA

Renderiza el documento (o una parte) y te DEVUELVE LA IMAGEN para que la veas. Se usa un duplicado: el original no se toca. Úsala después de cada cambio importante. Opciones: crop (zona en px), layer/artboard (recorta a esa capa), showOnly/hide/show (aislar capas).

Inputs: doc, crop, hide, show, +7 more.

ps_project_reportFicha técnica del proyectoA

Un solo informe en texto: configuración del documento, recursos que toma (fuentes, vinculados, bibliotecas CC, incrustados, problemas), estructura de capas en 2 niveles y cómo está definido el diseño (tipografía, color, efectos, mezcla, opacidad vs relleno, imágenes). Es lo primero que conviene leer al recibir un PSD ajeno.

Inputs: doc.

ps_remove_backgroundQuitar fondo (IA)B

Quita el fondo de una capa con la IA de Photoshop (crea una máscara).

Inputs: layer (required), doc.

ps_resourcesRecursos del documentoA

Qué recursos usa el proyecto y cómo están definidos: fuentes (instaladas o no), archivos vinculados (ruta, biblioteca de Creative Cloud, perdidos/modificados), objetos inteligentes incrustados, colores de texto y problemas detectados.

Inputs: doc.

ps_run_actionEjecutar acción grabadaC

Reproduce una acción grabada en Photoshop (nombre y conjunto).

Inputs: set (required), name (required).

ps_run_script_fileEjecutar archivo .jsxC

Ejecuta un script .jsx/.jsxbin del disco dentro de Photoshop.

Inputs: path (required).

ps_saveGuardarA

Guarda el documento (PSD, PSB, TIFF, PNG, JPG). Sin path guarda sobre su archivo. asCopy=true no cambia el documento abierto.

Inputs: doc, path, asCopy, format, +1 more.

ps_selectionSeleccionesC

Crea o modifica la selección: all, none, invert, rect, ellipse, polygon, layer (transparencia de una capa), subject (IA), colorRange. mode: replace/add/subtract/intersect. grow/shrink/smooth/border/feather. then: fill, clear, stroke, copyToLayer, cutToLayer, saveAs, mask, deselect.

Inputs: doc, grow, mode, rect, +12 more.

ps_set_documentAjustar documentoC

Cambia la configuración del documento: tamaño de imagen/lienzo, resolución, modo, profundidad, perfil de color (convertir/asignar), recortar, rotar, guías.

Inputs: doc, mode, trim, guides, +8 more.

ps_set_layerModificar capaC

Cambia casi todo de una capa: nombre, visibilidad, opacidad, relleno, modo de fusión, recorte, bloqueo, etiqueta de color; posición (x,y,anchor / moveBy), tamaño (size / resize %), rotación, sesgo, volteo; orden (order/parent/above/below); color de una forma, trazo de forma, 'Mezclar si' (blendIf), máscara y efectos.

Inputs: layer (required), x, y, doc, +26 more.

ps_smart_objectObjetos inteligentesC

Convertir una capa en objeto inteligente, reemplazar su contenido por otro archivo, abrir su contenido para editar, revincular, incrustar o convertir a vinculado.

Inputs: layer (required), doc, path, action.

ps_statusEstado de PhotoshopA

Conecta con Photoshop (lo abre si está cerrado) y devuelve versión, documentos abiertos, documento y capa activos.

Inputs: no named parameters.

ps_style_analyzeAprender un estiloA

Lee uno o varios PSD (abiertos o por ruta; los abre y los cierra sin guardar) y aprende el estilo de la persona: formato del lienzo, paleta (incluida la real del render), tipografía por jerarquía, recetas de efectos, hábitos de mezcla/opacidad/relleno, formas, recursos, estructura de capas y maquetación. Lo guarda como estilo con nombre y genera una guía. Úsalo con trabajos terminados de la persona.

Inputs: name (required), docs, files, merge, +1 more.

ps_style_getGuía del estiloA

Devuelve la guía de un estilo (dirección de arte en palabras, paleta con roles, tipografía por jerarquía, presets de texto, recetas de efectos, hábitos y reglas de composición). Léela ANTES de diseñar para la persona y sigue sus reglas. section limita: guide | tokens | recipes | presets | raw.

Inputs: name, section.

ps_style_listEstilos guardadosA

Lista los estilos guardados y cuál está activo.

Inputs: no named parameters.

ps_style_setEditar estiloB

Activa un estilo, o agrega/edita presets de texto, recetas de efectos o colores con nombre. Útil para afinar lo que el análisis dedujo.

Inputs: name, note, color, delete, +3 more.

ps_text_infoLeer textoB

Lee una capa de texto: contenido, tipo (punto/párrafo), rotación, escala y cada tramo con su estilo real.

Inputs: layer (required), doc.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    C2.9/5.0

    Scored across 47 tools

    Disambiguation3/5

    Several tools provide overlapping information (ps_status, ps_document_info, ps_project_report, ps_resources) or can perform similar operations (ps_selection can fill/mask, overlapping with ps_fill and ps_mask). However, detailed descriptions clarify intended use, so boundaries are mostly discernible.

    Naming Consistency3/5

    All tools share the ps_ prefix and snake_case, but the naming pattern is mixed: some are noun-only (ps_layers, ps_fonts, ps_mask), some verb_noun (ps_add_text, ps_create_layer), and some verb (ps_open, ps_save). This inconsistency makes the pattern less predictable.

    Tool Count2/5

    47 tools is excessive for an MCP server, exceeding the 25+ threshold for 'too many'. While Photoshop is complex, many tools could be consolidated (e.g., info tools, script runners), and the sheer count increases selection complexity.

    Completeness4/5

    The surface covers document, layer, text, shape, mask, selection, filter, adjustment, style, and export operations comprehensively. Minor gaps exist (e.g., layer comps, channel operations, artboard editing), but escape hatches like ps_execute_script and ps_action_manager allow workarounds.

    Maintenance

    ActivitySlowing
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables AI assistants to control Adobe Photoshop programmatically through natural language, with state awareness, recipe tools, and a standalone UI.
      9,794 npm
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      An MCP server that lets AI assistants drive Adobe Photoshop on Windows through ExtendScript and COM automation, offering ~122 tools for documents, layers, text, filters, color, selections, masks, layout QA, and design systems.
      3
      MIT
    • A
      license
      B
      quality
      C
      maintenance
      Enables AI agents to drive Adobe Photoshop on macOS through natural language, covering autonomous Adobe Firefly generative fill and object removal, Sensei AI sky and subject selection, non-destructive layer, adjustment, and text tooling, plus photographic workflows like sky harmonization and distraction removal. It also supports full document management, Camera Raw adjustments, and raw ExtendScript execution for custom operations.
      47
      MIT