Free Photoshop MCP
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Free Photoshop MCP haz una diapositiva 1:1 con mi estilo, mírala y corrígela"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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.
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_previewle devuelve la imagen para que corrija solo.Aprende tu estilo:
ps_style_analyzelee 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 conpreset:'titulo'yeffects:{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
Descarga Videazo-Photoshop-MCP-Setup.exe (36 MB).
Ábrelo, deja marcados los agentes que quieras conectar y pulsa Instalar. No pide administrador.
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 |
|
Ver |
|
Crear |
|
Modificar |
|
Organizar |
|
Estilo |
|
Salida libre |
|
Aprender tu estilo
ps_style_analyzecon tus PSD terminados (los abre, los lee y los cierra sin guardar).Se guarda en
%APPDATA%\Videazo\photoshop-mcp\styles\<nombre>.jsony.md(la guía).Antes de diseñar, tu agente lee
ps_style_gety sigue la guía. En las llamadas usapreset:'titulo'yeffects:{recipe:'sombra-x3+resplandor-verde'}.Afina con
ps_style_set(presets, colores con nombre, notas) o guarda cualquier capa que te guste conps_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 toolsps_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
Scored across 47 tools
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.
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.
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.
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
Related MCP Connectors
Give your AI agents a design superpower. Generate, edit, and publish publication-grade decks, reports, landing pages, resumes, and marketing visuals directly within your agent workflow. Delivering frontier-level design quality at 3× the speed and 53× lower cost -from conversational prompt to live link or vector PDF in minutes.
Agent-Native design tool - create and edit visual designs with agent assistance
Build and run visual creative-production workflows from your AI agent.
AI-agent design tools: fonts, font recognition, palettes, color naming, contrast, code, SVG, CSS.
Related MCP Servers
- AlicenseAqualityAmaintenanceEnables AI assistants to control Adobe Photoshop programmatically, supporting recipe workflows, state awareness, and generative AI features through natural language commands.1289,794 npm876MIT
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to control Adobe Photoshop programmatically through natural language, with state awareness, recipe tools, and a standalone UI.9,794 npmMIT
- AlicenseNot gradedqualityDmaintenanceAn 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.3MIT
- AlicenseBqualityCmaintenanceEnables 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.47MIT