Photoshop MCP Server

Um servidor MCP para integrar e automatizar o Adobe Photoshop usando a photoshop-python-api.

GitHub
294
Experimente este MCPPatrocinado

Documentação

Servidor MCP do Photoshop

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

⚠️ SOMENTE WINDOWS: Este servidor só funciona em sistemas operacionais Windows devido à sua dependência de interfaces COM específicas do Windows.

Um servidor Model Context Protocol (MCP) para integração com o Photoshop usando photoshop-python-api.

Inglês | 简体中文

Visão Geral

Este projeto fornece uma ponte entre o Model Context Protocol (MCP) e o Adobe Photoshop, permitindo que assistentes de IA e outros clientes MCP controlem o Photoshop programaticamente.

Photoshop MCP Server Demo

O Que Ele Pode Fazer?

Com este servidor MCP, assistentes de IA podem:

  • Criar, abrir e salvar documentos do Photoshop
  • Criar e manipular camadas (texto, cor sólida, etc.)
  • Obter informações sobre a sessão do Photoshop e documentos
  • Aplicar efeitos e ajustes em imagens
  • E muito mais!

Requisitos

Requisitos do Sistema

  • 🔴 SOMENTE SISTEMA OPERACIONAL WINDOWS: Este servidor SOMENTE funciona em sistemas operacionais Windows
    • O servidor depende de interfaces COM específicas do Windows para se comunicar com o Photoshop
    • macOS e Linux NÃO são suportados e NÃO PODEM executar este software

Requisitos de Software

  • Adobe Photoshop: Deve estar instalado localmente (testado com as versões CC2017 até 2024)
  • Python: Versão 3.10 ou superior

Instalação

Nota: Lembre-se de que este pacote só funciona em sistemas Windows.

# Install using pip
pip install photoshop-mcp-server

# Or using uv
uv install photoshop-mcp-server

Configuração do Host MCP

Este servidor foi projetado para funcionar com vários hosts MCP. A variável de ambiente PS_VERSION é usada para especificar qual versão do Photoshop conectar (por exemplo, "2024", "2023", "2022", etc.).

A maneira recomendada de configurar o servidor é usando uvx como comando, que é o formato padrão oficial.

Configuração Padrão (Recomendada)

Adicione o seguinte à configuração do seu host MCP (funciona com Claude Desktop, Windsurf, Cline e outros hosts MCP):

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

Opções de Configuração

  • PS_VERSION: Especifique a versão do Photoshop para conectar (por exemplo, "2024", "2023", "2022", etc.)
  • command: Use uvx para a abordagem padrão
  • args: Use ["photoshop-mcp-server"] para executar o servidor MCP do Photoshop
    • Para especificar uma versão do Python explicitamente, use ["--python", "3.10", "photoshop-mcp-server"] (qualquer versão de 3.10 a 3.14 é suportada)

Principais Recursos

Recursos Disponíveis

  • photoshop://info - Obter informações do aplicativo Photoshop
  • photoshop://document/info - Obter informações do documento ativo
  • photoshop://document/layers - Obter camadas no documento ativo

Ferramentas Disponíveis

O servidor fornece várias ferramentas para controlar o Photoshop:

  • Ferramentas de Documento: Criar, abrir e salvar documentos
  • Ferramentas de Camada: Criar camadas de texto, camadas de cor sólida, etc.
  • Ferramentas de Sessão: Obter informações sobre a sessão do Photoshop, documento ativo, seleção

Exemplos de Prompts para Assistentes de IA

Uma vez configurado no seu host MCP, você pode usar o servidor MCP do Photoshop nas conversas do seu assistente de IA. Aqui estão alguns exemplos de prompts para começar:

Exemplos 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".

Exemplos Mais Avançados

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.

Licença

MIT

Agradecimentos