photoshop-mcp

Photoshop MCP

言語： English · 简体中文 · Español · Deutsch · 日本語 · Türkçe · ウェブサイト

同僚に話しかけるように、Photoshopとチャットできます。 「この背景を削除して」「これらの画像をInstagram用にサイズ変更して」のように、普通の言葉でやりたいことを伝えるだけで、AI アシスタントが代わりにクリック操作を行います。Cursor、Claude、または内蔵のチャットウィンドウで使えます。コードもスクリプトもIDEも必要ありません。

注： これは非公式のコミュニティ運営プロジェクトであり、Adobe Inc.とは提携しておらず、同社から承認を受けてもいません。

新機能：Jevによる即時編集

すべてのプロンプトに言語モデルが必要なわけではありません。内蔵のチャットウィンドウで、TypeSafe AIのSystem OneモデルであるJev（TypeSafe AI）に、LLMを実行する前に各メッセージの振り分け先を判断させられるようになりました。元に戻す、不透明度、ブレンドモード、背景の削除、カラーグレーディング、カルーセルの分割など、26種類の安全なコマンドやレシピのいずれかを依頼したとJevが確信した場合、または「白黒にして、それから不透明度を50に」のような短い連続操作の場合は、Photoshopで即座に実行されます。LLMの呼び出しも、LLMのトークン消費もありません。それ以外のリクエストや、結合、統合など元に戻しにくい操作は、アクションプランに送られます。

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

試験的な機能で、オプトイン方式です。キーがなければUIは従来どおり動作し、TypeSafeにデータが送信されることはありません。キーがある場合は、プロンプトもapi.typesafe.aiに送信されます。振り分け方法、しきい値、無効化の手順については、docs/standalone-ui.mdをご覧ください。

できること

• ✂️ 背景を削除 — 被写体をきれいな編集可能なマスクで切り抜きます
• 👤 ポートレートをレタッチ — 肌のスムージング、色調の調整、覆い焼き・焼き込みの設定
• 🌐 Web とソーシャルメディア向けに書き出し — sRGB に変換し、シャープ処理を施して、Instagram、X などに合わせたサイズに調整します
• 🎞️ カルーセルを作成 — 横長のデザインを、つなぎ目のない番号付きスライドに分割します
• 💧 透かしを一括で追加 — フォルダー内の写真すべてに一度で適用します。オリジナルは変更されません
• 🎨 カラーグレーディングなど — フィルム風の色調、空の置き換え、生成塗りつぶし（Adobe アカウントが必要）
• ⏪ 安心して操作 — 複数ステップの「レシピ」はすべて、Photoshop で 1 回の取り消し操作で元に戻せます

内部には、128 個のツール（基本ツール 111 個＋ワンステップレシピ 17 個）があります。全リストは docs/available-tools.md をご覧ください。

こんなふうに頼んでみましょう

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.

ほかのレシピ（一括透かし、パスポート写真、CSV から作成するカード、モックアップなど）や 事前に設計されたプロンプトテンプレートについては、docs/prompt-layer.md をご覧ください。

始める

Photoshop が起動していること（Windows または macOS、2012 年以降のすべてのバージョン）と、Node.js 18+ が必要です。

オプション 1 — 最も簡単：組み込みのチャットウィンドウ

npx -p @alisaitteke/photoshop-mcp ui

ブラウザーでチャットウィンドウが開きます。AI プロバイダーの API キーでサインインするか、既存の Claude Code / Gemini CLI アカウントをキーなしで再利用できます。

詳細、プロバイダー、アクションプラン（API キーまたは CLI アカウント）、セキュリティに関する注意事項： docs/standalone-ui.md。

オプション 2 — AI アプリ内で使う（Cursor、Claude、VS Code）

Cursor（MCP リストに Photoshop のロゴが表示されます）： Customize → Plugins からプラグインをインストールするか、Cursor Marketplace で photoshop-mcp を検索してください（掲載後に利用可能になります）。このパッケージは引き続き npx -y @alisaitteke/photoshop-mcp を起動します。アイコンはプラグインマニフェストによって表示されます。

Marketplace に掲載されるまでは、.cursor-plugin/、mcp.json、assets/ を ~/.cursor/plugins/local/photoshop-mcp にコピーして、ウィンドウを再読み込みしてください。詳しくは CONTRIBUTING.md をご覧ください。Cursor にインストールボタンと生の mcp.json エントリも引き続き使えますが、汎用アイコンが表示されます。

Claude Code：

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

または、MCP クライアントの設定に以下を追加してください（Cursor、Claude Desktop など）：

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

仕組み

1. やりたいことを入力 — 普通の言葉で指示します。
2. AI が手順を計画 — まずドキュメントの状態を確認します。
3. Photoshop が実行 — 各レシピは 1 回で取り消せるステップとして適用されます。

問題が発生しましたか？ AI は構造化されたエラーを読み取り、次に試すべきことを判断します。 よくある問題の解決方法は、docs/troubleshooting.md をご覧ください。

ドキュメント

• 利用可能なツール — パラメーターを含む 128 個すべてのツール
• スタンドアロン UI — プロバイダー、認証モード、アクションプラン、セキュリティ
• プロンプトレイヤー — プロンプトテンプレートとレシピ
• アーキテクチャ — ブリッジの内部動作
• 開発 — ソースからのビルド、テスト

コントリビューション

コントリビューションを歓迎します！PR を作成する前に、CONTRIBUTING.md をお読みください。

❤️ コントリビューターとクレジット

コントリビューターの皆さまに感謝します！

メンテナー

Ali Sait Teke が開発しました — GitHub · LinkedIn.

ライセンス

MIT

匿名の集計済み利用状況分析データはデフォルトで収集されます。いつでも無効にできます。詳細は docs/anonymous-usage-analytics.md をご覧ください。