Photoshop MCP Server

Un servidor MCP para integrar y automatizar Adobe Photoshop utilizando photoshop-python-api.

GitHub
294
Prueba este MCPPatrocinado

Documentación

Servidor MCP de Photoshop

PyPI Version PyPI Downloads Build Status License Python Version Platform GitHub stars GitHub issues GitHub last commit

⚠️ SOLO WINDOWS: Este servidor solo funciona en sistemas operativos Windows debido a su dependencia de interfaces COM específicas de Windows.

Un servidor de Protocolo de Contexto de Modelo (MCP) para la integración de Photoshop usando photoshop-python-api.

Inglés | 简体中文

Descripción General

Este proyecto proporciona un puente entre el Protocolo de Contexto de Modelo (MCP) y Adobe Photoshop, permitiendo que asistentes de IA y otros clientes MCP controlen Photoshop de forma programática.

Photoshop MCP Server Demo

¿Qué Puede Hacer?

Con este servidor MCP, los asistentes de IA pueden:

  • Crear, abrir y guardar documentos de Photoshop
  • Crear y manipular capas (texto, color sólido, etc.)
  • Obtener información sobre la sesión de Photoshop y los documentos
  • Aplicar efectos y ajustes a las imágenes
  • ¡Y mucho más!

Requisitos

Requisitos del Sistema

  • 🔴 SOLO SISTEMA OPERATIVO WINDOWS: Este servidor SOLO funciona en sistemas operativos Windows
    • El servidor depende de interfaces COM específicas de Windows para comunicarse con Photoshop
    • macOS y Linux NO son compatibles y NO PUEDEN ejecutar este software

Requisitos de Software

  • Adobe Photoshop: Debe estar instalado localmente (probado con versiones CC2017 hasta 2024)
  • Python: Versión 3.10 o superior

Instalación

Nota: Recuerda que este paquete solo funciona en sistemas Windows.

# Install using pip
pip install photoshop-mcp-server

# Or using uv
uv install photoshop-mcp-server

Configuración del Host MCP

Este servidor está diseñado para funcionar con varios hosts MCP. La variable de entorno PS_VERSION se utiliza para especificar qué versión de Photoshop conectar (por ejemplo, "2024", "2023", "2022", etc.).

La forma recomendada de configurar el servidor es usando uvx como comando, que es el formato estándar oficial.

Configuración Estándar (Recomendada)

Agrega lo siguiente a la configuración de tu host MCP (funciona con Claude Desktop, Windsurf, Cline y otros hosts MCP):

{
  "mcpServers": {
    "photoshop": {
      "command": "uvx",
      "args": ["--python", "3.10", "photoshop-mcp-server"],
      "env": {
        "PS_VERSION": "2024"
      }
    }
  }
}

Opciones de Configuración

  • PS_VERSION: Especifica la versión de Photoshop a la que conectarse (por ejemplo, "2024", "2023", "2022", etc.)
  • command: Usa uvx para el enfoque estándar
  • args: Usa ["photoshop-mcp-server"] para ejecutar el servidor MCP de Photoshop
    • Para especificar una versión de Python explícitamente, usa ["--python", "3.10", "photoshop-mcp-server"] (se admite cualquier versión de 3.10 a 3.14)

Características Clave

Recursos Disponibles

  • photoshop://info - Obtener información de la aplicación de Photoshop
  • photoshop://document/info - Obtener información del documento activo
  • photoshop://document/layers - Obtener capas en el documento activo

Herramientas Disponibles

El servidor proporciona varias herramientas para controlar Photoshop:

  • Herramientas de Documento: Crear, abrir y guardar documentos
  • Herramientas de Capa: Crear capas de texto, capas de color sólido, etc.
  • Herramientas de Sesión: Obtener información sobre la sesión de Photoshop, documento activo, selección

Ejemplos de Prompts para Asistentes de IA

Una vez configurado en tu host MCP, puedes usar el servidor MCP de Photoshop en tus conversaciones con el asistente de IA. Aquí hay algunos ejemplos de prompts para comenzar:

Ejemplos Básicos

User: Can you create a new Photoshop document and add a text layer with "Hello World"?

AI Assistant: I'll create a new document and add the text layer for you.

[The AI uses the Photoshop MCP server to:
1. Create a new document using the `create_document` tool
2. Add a text layer using the `create_text_layer` tool with the text "Hello World"]

I've created a new Photoshop document and added a text layer with "Hello World".

Ejemplos Más Avanzados

User: Open my latest PSD file and tell me how many layers it has.

AI Assistant: I'll check your latest PSD file and count the layers.

[The AI uses the Photoshop MCP server to:
1. Get information about open documents
2. If no document is open, it can browse and open a PSD file
3. Retrieve and analyze the layer structure]

Your document has 12 layers, including 3 group folders and 2 adjustment layers.

User: Create a social media post with a gradient background and the text "Summer Sale" in a bold font.

AI Assistant: I'll create that social media post for you.

[The AI uses the Photoshop MCP server to:
1. Create a new document with appropriate dimensions for social media
2. Create a gradient fill layer with summer colors
3. Add a text layer with "Summer Sale" in a bold font
4. Position and style the text appropriately]

I've created your social media post with a gradient background and bold "Summer Sale" text.

Licencia

MIT

Agradecimientos