alisaitteke/photoshop-mcp

What it solves

Photoshop MCPは、AIアシスタントを介してAdobe Photoshopを制御する際の困難さを解決します。標準的な自動化スクリプトは、しばしば脆弱で文脈が欠けているため、AIエージェントが試行錯誤にトークンを浪費したり、ドキュメントを不整合な状態にしたりすることがあります。このプロジェクトは、AIアシスタントに状態認識能力を与え、自然言語を使用して複雑なデザインワークフローを実行するための構造化された方法を提供する堅牢なブリッジを提供します。

How it works

これは、LLM（ClaudeやCursorなど）がプログラム的にPhotoshopを制御できるようにするModel Context Protocol (MCP) サーバーを実装しています。このシステムは以下の機能を備えています：

• State Awareness: get_state や get_preview のようなツールにより、AIは現在のドキュメントを確認し、base64 JPEG経由で結果を検証できます。
• Recipe Tools: 16個の高レベルな「レシピ」 (e.g., 背景削除、カラーグレーディング) が、多段階のプロセスを単一の、取り消し可能なアクションにラップします。
• Prompt Layer: 23個の事前設計されたテンプレートが、LLMが曖昧なユーザーリクエストを正確なツール呼び出しに変換するのを助けます。
• Standalone UI: APIキーまたは既存のCLIサブスクリプション (Claude Code/Gemini CLI) をサポートするローカルWebインターフェースにより、IDEを必要とせずにPhotoshopを駆動できます。
• Action Plan (beta): 1回のLLM呼び出しで一連の手順全体を計画し、1回のパスで実行することで、往復回数を減らすモードです。

Who it’s for

繰り返しの多いPhotoshopタスクを自動化したい、データ駆動型のグラフィックスを作成したい、または自然言語コマンドを使用して複雑な画像操作を行いたいデザイナーや開発者。

Highlights

• 118 Total Tools: 102個の原子的なツールと16個の結果指向のレシピが含まれています。
• Generative AI Integration: Generative Fill、Expand、UpscaleなどのAdobe Firefly機能をサポートしています。
• Neural Filter Support: オプションのUXPブリッジプラグインを介して、肌の平滑化、深度のぼかし、カラー化にアクセスできます。
• Non-Destructive Workflows: レシピは元のピクセルを保持するために、単一の「元に戻す」ステップとして設計されています。
• Flexible Auth: APIキーまたはCLI OAuthセッションを介して、複数のプロバイダー (Anthropic, OpenAI, Google, OpenRouter) をサポートしています。