Photoshop MCP Server

Ein Model Context Protocol (MCP)-Server, der KI-Assistenten (Claude, opencode, Cursor usw.) ermöglicht, Adobe Photoshop unter Windows über ExtendScript + COM-Automatisierung zu steuern.

Entwickelt für Photoshop 2020 (v21.x), aber kompatibel mit neueren Versionen. ~122 Tools für Dokumente, Ebenen, Text, Filter, Farbanpassungen, Auswahlen & Masken, Ebenenstile, Export, Layout-Analyse, Design-QA und Photoshop-Status-Introspektion.

Inoffizielles Community-Projekt. Nicht mit Adobe verbunden oder von Adobe unterstützt.

So funktioniert es

MCP client (opencode/Claude) 
   → Node MCP server (server.js, stdio)
   → bridge.ps1 (PowerShell)
   → Photoshop COM (Application.DoJavaScriptFile)
   → ExtendScript DOM

• ExtendScript, nicht UXP — externe Automatisierung über COM kann nur ExtendScript verwenden, das auf allen Photoshop-Versionen (2012–2025+) funktioniert. UXP ist für In-Process-Plugins gedacht und kann nicht extern aufgerufen werden.

• Unicode-sicher — Nicht-ASCII-Text (z. B. £, —) wird in generiertem JSX zu \uXXXX maskiert und ein UTF-8-BOM wird vorangestellt, damit Preise/Akzente korrekt hin- und zurückkonvertiert werden.

• Wiederholung bei Beschäftigt — vorübergehende COM-Fehler RPC_E_SERVERCALL_RETRYLATER („Anwendung ist beschäftigt") werden mit Backoff wiederholt.

Related MCP server: ImageMcp

Anforderungen

• Windows

• Adobe Photoshop installiert (getestet mit PS 2020 / v21.2)

• Node.js 18+

Installation

npm install

Als MCP-Server konfigurieren

Fügen Sie dies zu Ihrer MCP-Client-Konfiguration hinzu (z. B. ~/.config/opencode/opencode.jsonc, Claude Desktop, Cursor):

{
  "mcpServers": {
    "photoshop": {
      "command": "node",
      "args": ["C:\\path\\to\\photoshop-mcp\\server.js"]
    }
  }
}

Starten Sie Ihren MCP-Client nach Änderungen neu, damit die aktualisierte Tool-Liste geladen wird.

Tool-Highlights

Führen Sie tools/list in Ihrem MCP-Client aus, um alle ~122 Tools zu sehen.

Konfigurationsreferenz

Bekannte Einschränkungen

• Generative KI (Firefly) und Neural-Filter benötigen PS 24+ / ein UXP-Bridge-Plugin und können nicht über ExtendScript gesteuert werden.

• select_subject benötigt PS 23+. export_as WebP/AVIF benötigt PS 23.2+.

• Unter PS 2020 zeigen einige Befehle eine Meldung „Photoshop ist beschäftigt" an, wenn ein modaler Dialog geöffnet ist — schließen Sie ihn und versuchen Sie es erneut.

Credits

Das Design der Fähigkeiten wurde inspiriert von:

• alisaitteke/photoshop-mcp

• loonghao/photoshop-python-api-mcp-server

Beide sind MIT-lizenziert. Dieses Projekt ist eine unabhängige Implementierung mit zusätzlichen Tools (Layout-Analyse, Design-QA, Design-Systeme, visuelle Regression).

Lizenz

MIT