YENZE / OPEN SOURCE · MCP

Tus capas.
Tu app.
Y tu agente.

compositor-mcp conecta Claude con Compositor, el Photoshop open source para Mac. Pides en lenguaje natural y el agente crea, apila, enmascara y renderiza capas en un proyecto .comp real, listo para seguir a mano.

Claude CodeClaude DesktopNode 20+MIT
COMPOSITOR-MCP / v0.1.3GRABACIÓN REAL, CÓDIGO REAL
Un paisaje de 19 capas, de cero, sin una foto36 s · pantalla real
ASK. STACK.
SHIP.

El agente ve lo que hace: pide una vista previa,
corrige y vuelve a renderizar.

✳
15 herramientas✳Formato .comp documentado✳Edición no destructiva✳Sin tocar la app
01 / CÓMO FUNCIONA

Tú describes.
El agente compone.

El servidor escribe directamente en el formato de Compositor: un manifest.json y un PNG por capa. No modifica la app y cada edición es no destructiva.

01

Pides en tu chat

"Crea un proyecto 1920×1080, mete la foto a sangre, el logo abajo a la derecha al 80 % en Multiply y enséñame la vista previa."

02

El agente edita el .comp

Llama a create_project, add_image_layer, set_layer y render_preview. Recibe el resultado como imagen y corrige lo que haga falta.

03

Lo abres en Compositor

Con open_in_compositor el proyecto aparece con sus capas, carpetas, máscaras y modos de fusión listos para seguir a mano.

02 / LAS HERRAMIENTAS

Quince operaciones.
Las del panel de capas.

Todo lo que harías con el ratón en el panel Layers, expuesto como herramientas MCP con validación del formato antes de escribir.

Leer y ver
  • inspect_project

    Lienzo, resolución y cada capa con carpeta, opacidad, fusión, transformación y máscara.

  • list_layers

    Vista compacta de arriba abajo, como el panel Layers.

  • render_preview

    Vista previa aplanada que el modelo recibe como imagen para ver lo que ha hecho.

  • export_flattened

    Exportación PNG o JPEG a resolución completa.

  • export_layer

    Copia los píxeles o la máscara de una capa a un archivo.

Crear y apilar
  • create_project

    Documento nuevo, con fondo sólido opcional.

  • add_image_layer

    Importa PNG, JPEG, HEIC, TIFF o WebP con ajuste, relleno o estirado, opacidad, fusión y carpeta.

  • add_folder

    Crea una carpeta de capas.

  • move_layer

    Reordena capas o muévelas entre carpetas.

  • remove_layer

    Borra una capa o una carpeta entera.

Editar y abrir
  • set_layer

    Renombrar, ocultar, opacidad, fusión, posición, tamaño, rotación, volteos, muestreo y máscara.

  • replace_layer_image

    Cambia los píxeles de una capa; ida y vuelta por otra herramienta o imagen generada.

  • set_layer_mask

    Adjunta una máscara en escala de grises, inviértela o quítala.

  • resize_canvas

    Cambia el tamaño del documento con ancla, sin remuestrear.

  • open_in_compositor

    Abre el proyecto en la app para seguir editando a mano.

03 / HECHO CON EL CONECTOR

Dos proyectos de cero.
Sin una sola foto.

Cada capa se generó por código, se importó con add_image_layer y se afinó mirando render_preview. El vídeo de arriba es la grabación de pantalla del primero.

Paisaje de montañas al atardecer con lago y pinos, generado por capas
PAISAJE_BRUTAL.COMP · 2560 × 1440

Paisaje al atardecer

19 capas: cielo, estrellas, sol, nubes, cuatro cordilleras con tres bandas de niebla, rayos de luz, bandada, lago con reflejo, bruma, pinos, etalonaje, viñeta y grano.

Generado con NumPy y PIL, apilado con el conector
Avatar caricatura estilo NFT con traje y medallón
CARTOON_DON_NFT.COMP · 2048 × 2048

Avatar caricatura

11 capas vectoriales dibujadas por código: fondo, halo, traje, cabeza, rasgos, pelo, bling, semitono y marco. Cada iteración se revisó con render_preview.

Capas reemplazadas con replace_layer_image en cada ronda
04 / EJEMPLOS PARA DISEÑADORES

Tres encargos de cada día,
resueltos capa a capa.

Cada vídeo muestra el proyecto construyéndose en orden: la capa que entra, su modo de fusión y la herramienta MCP que la crea. Los tres archivos .comp se abren en Compositor con todo editable.

CARTEL.COMP · 1080 × 1350 · 8 CAPAS

Cartel para redes

Fondo, formas, semitono en Overlay, tipografía, pegatina rotada con set_layer y grano al 40 %. Un formato 4:5 listo para Instagram o un póster.

  • add_image_layer
  • set_layer · rotation
  • Overlay
MOCKUP.COMP · 1600 × 1200 · 7 CAPAS

Mockup de app

Sombra en Multiply, teléfono, pantalla, un reflejo en Screen recortado con una máscara de degradado y tarjetas flotantes. Presentación de producto sin abrir otra herramienta.

  • set_layer_mask
  • Screen · 35 %
  • Multiply
DUOTONO.COMP · 2560 × 1440 · 5 CAPAS

Duotono con máscara

Copia en blanco y negro, sombras en Lighten y luces en Multiply, las tres con la misma máscara para ver el antes y el después en una sola imagen.

  • set_layer_mask
  • Lighten + Multiply
  • replace_layer_image
05 / INSTALAR

Un comando.
Y a componer.

Requiere Node.js 20 o superior. Compositor solo hace falta para mirar el resultado: el servidor trabaja sobre el archivo .comp.

Claude Code

claude mcp add compositor -- npx -y compositor-mcp

Claude Desktop

claude_desktop_config.json
{
  "mcpServers": {
    "compositor": {
      "command": "npx",
      "args": ["-y", "compositor-mcp"]
    }
  }
}

Compositor no vigila cambios en disco: si el agente edita un proyecto que ya tienes abierto, cierra y vuelve a abrir el documento. Los ajustes, efectos y texto que el conector aún no entiende se conservan intactos en la ida y vuelta.

DEL ESTUDIO AL CÓDIGO

Lo hice para diseñar
con un agente al lado.

Soy Josu Sanz. Quería que Claude trabajase sobre mis propios documentos por capas sin exportar a un formato intermedio, así que escribí el conector sobre el formato documentado de Compositor. Es MIT, como la app de Robbie Tilton.

Forma parte de las herramientas que publicamos en abierto desde Yenze, junto a yenze-feedback.

ANTES DE INSTALAR

Las cosas,
claras.

PARA TU PRODUCTO. CON TUS DATOS.

¿Un conector MCP
para tu herramienta?

Diseñamos servidores MCP que dan a los agentes acceso seguro a tu producto, tu formato o tu API. Cuéntanos qué quieres que un agente pueda hacer.

Hablemos de tu conector ↗