Photoshop MCP Server

Photoshop MCP サーバー

⚠️ WINDOWS ONLY：Windows 固有の COM インターフェースに依存しているため、このサーバーは Windows オペレーティングシステムでのみ動作します。

photoshop-python-api を使用して Photoshop と連携するための Model Context Protocol（MCP）サーバーです。

English | 简体中文

概要

このプロジェクトは、Model Context Protocol（MCP）と Adobe Photoshop をつなぐブリッジを提供し、AI アシスタントやその他の MCP クライアントから Photoshop をプログラムで操作できるようにします。

できること

この MCP サーバーを使うと、AI アシスタントは次のことができます。

• Photoshop ドキュメントの作成、オープン、保存
• レイヤー（テキスト、単色など）の作成と操作
• Photoshop のセッションとドキュメントに関する情報の取得
• 画像へのエフェクトや調整の適用
• その他多数！

要件

システム要件

• 🔴 WINDOWS OS ONLY：このサーバーは Windows オペレーティングシステムでのみ動作します
  • サーバーは Photoshop との通信に Windows 固有の COM インターフェースを使用します
  • macOS と Linux はサポートされておらず、このソフトウェアを実行できません

ソフトウェア要件

• Adobe Photoshop：ローカルにインストールされている必要があります（CC2017 から 2024 までのバージョンでテスト済み）
• Python：バージョン 3.10 以降

インストール

注：このパッケージは Windows システムでのみ動作します。

# Install using pip
pip install photoshop-mcp-server

# Or using uv
uv install photoshop-mcp-server

MCP ホストの設定

このサーバーは、さまざまな MCP ホストで動作するように設計されています。環境変数 PS_VERSION を使用して、接続する Photoshop のバージョン（例：「2024」、「2023」、「2022」など）を指定します。

サーバーの設定には、標準の公式形式である uvx をコマンドとして使用する方法をおすすめします。

標準設定（推奨）

MCP ホストの設定に次の内容を追加します（Claude Desktop、Windsurf、Cline、およびその他の MCP ホストで動作します）。

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

設定オプション

• PS_VERSION：接続する Photoshop のバージョン（例：「2024」、「2023」、「2022」など）を指定します
• command：標準的な方法として uvx を使用します
• args：Photoshop MCP サーバーを実行するには ["photoshop-mcp-server"] を使用します
  • Python のバージョンを明示的に指定するには、["--python", "3.10", "photoshop-mcp-server"] を使用します（3.10 から 3.14 までのバージョンに対応しています）

主な機能

利用可能なリソース

• photoshop://info - Photoshop アプリケーションの情報を取得します
• photoshop://document/info - アクティブなドキュメントの情報（名前、幅、高さ、解像度、レイヤー数）を取得します。Photoshop がドキュメントの寸法を報告しない場合、width／height は 0.0 になり、追加の dimensions_unavailable: true フィールドによって、実際にゼロなのではなく読み取れないことが示されます。photoshop_open_document も同じ情報を報告します。
• photoshop://document/layers - アクティブなドキュメントのレイヤーを取得します

利用可能なツール

このサーバーは、Photoshop を操作するためのさまざまなツールを提供します。

• ドキュメントツール：ドキュメントの作成、開く、保存
• レイヤーツール：テキストレイヤーや単色レイヤーなどの作成
• セッションツール：Photoshop セッション、アクティブなドキュメント、選択範囲の情報を取得
• スクリプトツール：photoshop_execute_jsx で任意の Photoshop JavaScript（JSX）を実行

photoshop_execute_jsx

あらゆる用途に対応する汎用の手段です。Photoshop JavaScript（ExtendScript／JSX）のスニペットを実行できるため、上記の専用ツールでは対応していない Photoshop API の機能（チャンネル、パス、ヒストリー状態、フィルター、カスタム自動化、バッチ処理など）にもアクセスできます。

• サポートされるスクリプト：実行中の Photoshop のバージョンが受け付ける Photoshop JavaScript なら、どれでも実行できます。Photoshop の ExtendScript エンジンは ECMAScript 3 に基づいているため、ES3 構文（var を使用し、アロー関数や let／const は使用しない）を使ってください。JSON.stringify のポリフィルが自動的に挿入されるため、エンジンにネイティブの JSON オブジェクトがなくても JSON.stringify(...) を使えます。
• スクリプトの種類：スクリプト本文を単一の文字列として渡してください。明示的な return 文で値を返すか、最後の式を結果として使用してください。
• 戻り値：成功時は { "success": true, "result": <script output> }、失敗時は { "success": false, "error": <message> } が返されます。Photoshop 内でスクリプトが例外をスローした場合も、Photoshop インスタンスにまったく接続できない場合も success: false が報告されるため、呼び出し側で両者を区別するためにペイロードを調べる必要はありません。

例：

// Count art layers in the active document
app.activeDocument.artLayers.length;

// Get every layer name as JSON
var doc = app.activeDocument;
var names = [];
for (var i = 0; i < doc.artLayers.length; i++) {
    names.push(doc.artLayers[i].name);
}
JSON.stringify(names);

注：スクリプトは Photoshop UI と同じ権限で実行されるため、アクティブなドキュメントを変更したり破損させたりする可能性があります。破壊的な自動化を実行する前に、作業内容を保存してください。

AI アシスタント向けのプロンプト例

MCP ホストで設定すると、AI アシスタントとの会話で Photoshop MCP サーバーを使用できます。使い始める際のプロンプト例をいくつか紹介します。

基本的な例

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

応用例

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.

ライセンス

MIT

謝辞

• photoshop-python-api - Photoshop 用 Python API
• Model Context Protocol - MCP Python SDK