photoshop-mcp

Photoshop MCP

Idiomas: English · 简体中文 · Español · Deutsch · 日本語 · Türkçe · Website

Converse com o Photoshop como um colega. Descreva o que você quer em palavras simples — "remova este fundo", "redimensione estes para o Instagram" — e seu assistente de IA faz os cliques por você. Funciona com Cursor, Claude ou a janela de chat integrada. Sem código, sem scripts, sem IDE necessário.

Nota: Este é um projeto não oficial, mantido pela comunidade, e não é afiliado ou endossado pela Adobe Inc.

Novo: edições instantâneas com Jev

Nem todo prompt precisa de um modelo de linguagem. A janela de chat integrada agora pode perguntar ao Jev, o modelo System One da TypeSafe AI, para onde cada mensagem deve ir antes de qualquer LLM ser executado. Quando o Jev está confiante de que você pediu um dos 26 comandos e receitas seguros (desfazer, opacidade, modo de mesclagem, remover fundo, correção de cor, carrossel dividido, …), ou uma sequência curta deles como "preto e branco, depois opacidade 50", ele executa no Photoshop imediatamente: sem chamada de LLM, sem tokens de LLM. Qualquer outra coisa, e etapas difíceis de desfazer como mesclar ou achatar, vai para o Plano de Ação.

TYPESAFE_API_KEY=... npx -p @alisaitteke/photoshop-mcp ui

Experimental e opcional. Sem a chave, a interface funciona exatamente como antes e nada é enviado para a TypeSafe; com ela, os prompts também vão para api.typesafe.ai. Rotas, limites e o interruptor de desativação: docs/standalone-ui.md.

O que ele pode fazer?

• ✂️ Remover fundos — sujeito isolado com uma máscara limpa e editável
• 👤 Retocar retratos — suavização de pele, correções de tom, configuração de dodge & burn
• 🌐 Exportar para web e redes sociais — sRGB, nitidez, tamanho correto para Instagram, X e mais
• 🎞️ Criar carrosséis — divida um design largo em slides numerados e contínuos
• 💧 Marca d'água em lote — uma pasta inteira de fotos de uma vez, originais intactos
• 🎨 Correção de cor e mais — looks de filme, substituição de céu, preenchimento generativo (conta Adobe necessária)
• ⏪ Fique seguro — cada "receita" de várias etapas é uma única etapa de desfazer no Photoshop

Por baixo dos panos: 127 ferramentas (111 atômicas + 16 receitas de uma etapa) — lista completa em docs/available-tools.md.

Experimente dizer

Remove the background from this portrait — keep it editable with a mask.

Enhance this portrait — smooth the skin and fix the tones, medium intensity.

Prepare this design for web, then export Instagram and X post variants.

Split this wide banner into a 5-slide seamless Instagram carousel.

Mais receitas (marca d'água em lote, fotos para passaporte, cartões orientados por CSV, mockups, …) e modelos de prompt pré-engenharia: docs/prompt-layer.md.

Comece agora

Você precisa do Photoshop em execução (Windows ou macOS, qualquer versão 2012+) e Node.js 18+.

Opção 1 — Mais fácil: a janela de chat integrada

npx -p @alisaitteke/photoshop-mcp ui

Uma janela de chat abre no seu navegador. Entre com uma chave de API do provedor de IA — ou reutilize sua conta existente do Claude Code / Gemini CLI, sem necessidade de chave.

Detalhes, provedores, Plano de Ação (chave de API ou conta CLI) e notas de segurança: docs/standalone-ui.md.

Opção 2 — Dentro do seu aplicativo de IA (Cursor, Claude, VS Code)

Cursor (mostra o logotipo do Photoshop na lista MCP): instale o plugin em Customize → Plugins, ou pesquise no Cursor Marketplace por photoshop-mcp quando estiver listado. Esse pacote ainda inicia o npx -y @alisaitteke/photoshop-mcp; o manifesto do plugin é o que fornece o ícone.

Até a listagem no Marketplace estar ativa, copie .cursor-plugin/, mcp.json e assets/ para ~/.cursor/plugins/local/photoshop-mcp e recarregue a janela — detalhes em CONTRIBUTING.md. O botão Install-in-Cursor e uma entrada bruta de mcp.json ainda funcionam, mas mostram um ícone genérico.

Claude Code:

claude mcp add photoshop -- npx -y @alisaitteke/photoshop-mcp

Ou adicione isto à configuração do seu cliente MCP (Cursor, Claude Desktop, …):

{
  "mcpServers": {
    "photoshop": {
      "command": "npx",
      "args": ["-y", "@alisaitteke/photoshop-mcp"]
    }
  }
}

Como funciona

1. Você digita o que quer em linguagem simples.
2. A IA planeja as etapas, verificando o estado do documento primeiro.
3. O Photoshop executa — cada receita chega como uma etapa desfazível.

Algo deu errado? A IA lê o erro estruturado e sabe o que tentar em seguida. Correções comuns: docs/troubleshooting.md.

Documentação

• Ferramentas disponíveis — todas as 127 ferramentas com parâmetros
• Interface autônoma — provedores, modos de autenticação, Plano de Ação, segurança
• Camada de prompt — modelos de prompt e receitas
• Arquitetura — como a ponte funciona por baixo dos panos
• Desenvolvimento — compilar a partir do código-fonte, testes

Contribuindo

Contribuições são bem-vindas! Por favor, leia CONTRIBUTING.md antes de abrir um PR.

❤️ Contribuidores e Créditos

Obrigado a todos os nossos contribuidores!

Mantenedor

Construído por Ali Sait Teke — GitHub · LinkedIn.

Licença

MIT

Análises de uso anônimas e agregadas são coletadas por padrão e podem ser desativadas a qualquer momento — detalhes em docs/anonymous-usage-analytics.md.