Photoshop MCP Server

Photoshop MCP サーバー

Adobe Photoshop を操作する MCP サーバーです。ドキュメント、画像とキャンバスのサイズ、レイヤーとグループ、選択範囲、調整とフィルター、文字、書き出し、履歴を操作できます。Photoshop がインストールされているマシン上で動作し、Photoshop に付属するスクリプティングインターフェイスである ExtendScript を通じて Photoshop と通信します。

macOS または Windows の Photoshop 2023 以降と、Node.js 18 以降が必要です。

インストール

Claude Code：

claude mcp add photoshop -- npx -y adobe-mcp-photoshop

mcpServers ブロックを読み込むクライアント（Claude Desktop、Cursor、Warp、…）：

{
  "mcpServers": {
    "photoshop": {
      "command": "npx",
      "args": ["-y", "adobe-mcp-photoshop"]
    }
  }
}

macOS では、最初の呼び出し時に Photoshop の操作許可を求められます（システム設定 > プライバシーとセキュリティ > オートメーション）。

規約

• 位置とサイズはピクセル単位です。使用しているルーラーの単位にかかわらず、ドキュメントの左上を基準とし、y は下方向に増加します。
• レイヤーは target で選択します：{ ids: [...] }、{ names: [...] }、または { active: true }。ID は Photoshop 独自のレイヤー ID で、list_layers と、レイヤーを作成するすべてのツールから取得できます。
• 色は "#RRGGBB"、"rgb(r,g,b)"、"cmyk(c,m,y,k)"、"gray(g)"、"hsb(h,s,b)"、または "lab(L,a,b)" です。
• 調整、フィルター、塗りつぶし、線は、選択範囲がある場合はその範囲内で、ピクセルレイヤーを変更します。
• タイムラインの時間は、タイムラインのフレームレートにおける { seconds, frames } です。
• フォントは PostScript 名で指定します。list_fonts で確認できます。
• ファイルは、ホームフォルダー内または PHOTOSHOP_ALLOWED_DIRS に指定されたディレクトリ内にある必要があります。

ツール

分野	ツール
ドキュメント	list_documents、get_document_info、create_document（ピクセル縦横比を指定、またはアートボード付き）、open_document（Photoshop が読み込める任意の形式。スマートオブジェクトとして開くこともできます。PDF、EPS、Photoshop Raw、DICOM ではそれぞれの読み込みオプションを指定できます）、save_document（PSD、PSB、TIFF、PNG、JPEG、PDF、GIF、EPS、DCS 1.0 および 2.0、BMP、Targa、Pixar、Photoshop Raw。それぞれの形式のオプションを指定できます。コピーとして保存することもできます）、duplicate_document、set_active_document、close_document、set_colors（描画色と背景色）
ファイル	manage_recent_files（一覧表示、開く、消去）、close_documents（すべて閉じる）、go_to_bridge、get_document_metadata および set_document_metadata（ファイル情報と XMP）、manage_document_notes（読み込み、消去、注釈ツール、注釈パネル）、set_file_handling_preferences（画像プレビュー、最近使用したファイル、ヒストリーログ）、place_file（埋め込みを配置またはリンクを配置。位置、拡大・縮小、回転を指定）
画像	resize_image（画像解像度：ピクセル、パーセント、解像度、再サンプル）、resize_canvas（基準位置を指定してカンバスサイズを変更）、crop_image、trim_image、rotate_canvas（または反転）、change_mode（カラーモードとビット深度）、convert_profile、flatten_image（または表示レイヤーを結合）、reveal_all
レイヤー	list_layers、create_layer（ピクセルレイヤーまたはグループ）、set_layer_properties（名前、不透明度、塗り、不透明度、描画モード、表示、ロック）、set_active_layer、arrange_layers、group_layers、ungroup_layers、duplicate_layers、delete_layers、merge_layers、transform_layers（移動、拡大・縮小、回転、反転）、rasterize_layers、link_layers、convert_background_layer、layer_comps
選択範囲	select_area（長方形、楕円形、多角形。現在の選択範囲と組み合わせ可能）、select_all（すべて、なし、反転）、modify_selection（拡張、縮小、ぼかし、滑らかに、境界線、近似色を選択、類似を選択）、transform_selection、fill_selection、stroke_selection、save_selection（アルファチャンネルへの保存、またはアルファチャンネルからの読み込み）、clipboard（コピー、結合部分をコピー、カット、消去、ペースト、選択範囲内へペースト）
色調補正とフィルター	adjust_layers（明るさ・コントラスト、レベル補正、トーンカーブ、露光量、自然な彩度、色相・彩度、カラーバランス、白黒、フォトフィルター、チャンネルミキサー、グラデーションマップ、特定色域の選択、シャドウ・ハイライト、ポスタリゼーション、二階調化、彩度を下げる、階調の反転、平均化、自動トーン、自動コントラスト、自動カラー）、apply_filter（ぼかし、シャープ、ハイパス、ノイズ、メディアン、ダスト＆スクラッチ、最大値、最小値、変形、オフセット、雲模様など）
色調補正レイヤーと塗りつぶしレイヤー	create_adjustment_layer（すべての色調補正タイプと各設定。クリッピングも可能）、edit_adjustment_layer、create_fill_layer（べた塗り、グラデーション、パターン）、edit_fill_layer
カラー	swap_colors（または黒と白にリセット）、pick_color（すべてのカラーモデルの値、ウェブセーフカラー）、sample_color（スポイトツールとカラーサンプラーツール）、define_pattern、assign_profile、set_color_preferences（カラー設定、ダイナミックスライダー、色域外警告の不透明度）、set_proof_view（校正設定、色の校正、色域外警告）
選択範囲	select_area（長方形、楕円形、多角形。現在の選択範囲と組み合わせ可能）、select_all（すべて、なし、反転）、modify_selection（拡張、縮小、ぼかし、滑らかに、境界線、近似色を選択、類似を選択）、transform_selection、fill_selection、stroke_selection、save_selection（アルファチャンネルへの保存、またはアルファチャンネルからの読み込み）、clipboard（コピー、結合部分をコピー、カット、消去、ペースト、選択範囲内へペースト、同じ位置にペースト、選択範囲外へペースト）
色調補正とフィルター	adjust_layers（明るさ・コントラスト、レベル補正、トーンカーブ、カラーバランス、フォトフィルター、シャドウ・ハイライト、ポスタリゼーション、二階調化、彩度を下げる、階調の反転、平均化、自動レベル、自動コントラスト）、apply_filter（ぼかし、シャープ、ハイパス、ノイズ、メディアン、ダスト＆スクラッチ、最大値、最小値、変形、オフセット、雲模様など）
描画とレタッチ	fill_contents（編集 > 塗りつぶし：描画色、背景色、ブラック、50％グレー、ホワイト、パターン、ヒストリー、コンテンツに応じる、およびスクリプトパターンのレンガ塗り、クロスウィーブ、パスに沿って配置、ランダム塗りつぶし、対称塗りつぶし）、draw_gradient（カラーと不透明度の停止点を指定する従来のグラデーション）、stroke_path（ブラシ、鉛筆、消しゴム、コピースタンプ、修復ブラシ、パターンスタンプ、覆い焼き、焼き込みなどのツールでパスに沿って描画）、fill_path、fill_at_point（塗りつぶしツール、マジック消しゴムツール）、set_tool_options（ツール、ブラシプリセット、サイズ、硬さ、不透明度、流量、モード、筆圧ボタン、滑らかさとそのオプション、混合ブラシのウェットと混合、許容値、隣接、描画カーソル）、set_brush_settings（ブラシ設定パネル：先端の形状、シェイプ、散布、テクスチャ、デュアルブラシ、カラー、その他のダイナミクス、トランスファー、ブラシポーズと各チェックボックス）、manage_brushes（プリセットの読み込み、書き出し、ブラシプリセットを定義、新規作成、名前変更、削除、リセット）、set_clone_source_options（コピースタンプソースパネル：ソース、変形をリセット、オーバーレイオプション）、retouch_selection（パッチツール、コンテンツに応じた移動）
色調補正とフィルター	adjust_layers（明るさ・コントラスト、レベル補正、トーンカーブ、カラーバランス、フォトフィルター、シャドウ・ハイライト、ポスタリゼーション、二階調化、彩度を下げる、階調の反転、平均化、自動レベル、自動コントラスト、自動カラー補正オプション、カラーの適用、色の置き換え）、apply_filter（ぼかし、シャープ、ハイパス、ノイズ、メディアン、ダスト＆スクラッチ、最大値、最小値、変形、オフセット、雲模様、レンズ補正、広角補正、フィルターギャラリーなど）
描画とレタッチ	fill_contents（編集 > 塗りつぶし：描画色、背景色、ブラック、50％グレー、ホワイト、パターン、ヒストリー、コンテンツに応じる）、draw_gradient（カラーと不透明度の停止点を指定する従来のグラデーション）、stroke_path（ブラシ、鉛筆、消しゴム、コピースタンプ、修復ブラシ、覆い焼き、焼き込みなどのツールでパスに沿って描画）、fill_path、fill_at_point（塗りつぶしツール、マジック消しゴムツール）、set_tool_options（ツール、ブラシプリセット、サイズ、硬さ、不透明度、流量、描画カーソル）、manage_brushes（読み込み、書き出し、ブラシプリセットを定義）、retouch_selection（パッチツール、コンテンツに応じた移動）
文字	create_text_layer（ポイント文字または段落文字）、set_text（テキスト、書式、位置、ワープ）、list_fonts
ビデオとアニメーション	get_timeline、create_timeline（ビデオタイムラインまたはフレームアニメーションの作成、または変換）、set_timeline（タイムラインパネル、フレームレート、再生ヘッド、アニメーションオプション）、run_timeline_command（移動とトリミング、分割、作業領域、キーフレーム、オニオンスキン、ビデオレイヤーフレーム）、edit_frame_animation（フレームの新規作成、削除、コピー、ペースト、逆再生、トゥイーン、レイヤーからフレームへ、またはフレームからレイヤーへ）、add_video_layer、import_video_frames、set_clip_timing（イン点とアウト点、デュレーション）、add_video_transition、render_video
ヒストリー	list_history、undo（戻る、進む、または特定の状態へ移動）、make_snapshot、edit_history（状態の復帰、削除、消去、状態から新規ドキュメントを作成、ヒストリーブラシのソース、消去）、set_history_options（ヒストリーオプションとヒストリーログ）
自動化	list_action_sets、edit_actions（セットの新規作成、削除、消去、リセット、.atn の読み込みまたは保存）、set_action_options（再生オプション、ボタンモード、ツールの記録）、run_action_batch（バッチ）、create_droplet、run_automate_command（写真を切り抜いて角度を補正、画像サイズに合わせる、条件付きモード変更、レンズ補正、空のレイヤーをすべて削除、すべてのレイヤー効果を統合、すべてのマスクを統合）、combine_images（ファイルをレイヤーとして読み込み、Photomerge、HDR Pro に統合、統計）、manage_script_events（スクリプトイベントマネージャー）、manage_data_sets（変数データセットの読み込み、適用、書き出し）
アートボード	get_artboards、create_artboard（新規作成、レイヤーから作成、グループから作成、またはアートボードドキュメントから作成）、edit_artboards（サイズ、位置、背景、自動ネスト、複製、グループ解除、ガイド、アートボードツールとフレームツール）、create_frame（レイヤーまたはグループから作成）、export_artboards（ファイルまたは単一の PDF に書き出し）
書き出し	export_image（Web 用に保存：PNG、PNG-8、JPEG、GIF。サイズ変更も可能）、export_layers（レイヤーまたはグループごとに1ファイル）、quick_export（ドキュメントまたは選択したレイヤー）、export_layer_comps（ファイルまたは単一の PDF に書き出し）、export_paths_to_illustrator、make_pdf_presentation（複数ページの PDF またはスライドショー）、generate_image_assets（Generator のアセットレイヤー名、デフォルトレイヤー、オンまたはオフ）
印刷	get_print_options、set_print_options（プリンター、部数、カラー処理と分版、プリントスペース、位置と倍率、トンボ、機能）、print_image（設定を使用、または1部）、apply_trap
ヒストリー	list_history、undo（戻る、進む、または特定の状態へ移動）、make_snapshot
アプリケーション	get_photoshop_info（バージョン、メモリ、システム情報、ファイル形式、機能チェック）、get_photoshop_preferences、set_photoshop_preferences（一般、インターフェイスとカラーテーマ、ファイル管理、パフォーマンス、カーソル、透明部分、単位と定規、ガイドとグリッド、プラグイン、文字、スクリプトダイアログ）、purge_photoshop_caches、run_photoshop_command（ビープ音、最前面に表示、更新、非表示、ヘルプ、アカウント）、run_photoshop_menu_item、manage_script_options（セッション間で保持する値）、quit_photoshop
インターフェイス	arrange_photoshop_windows（並べて表示、2画面から6画面、タブ、フローティング、ズームと位置を一致）、set_zoom_and_screen_mode、toggle_view_extras（エクストラ、項目の表示、定規、スナップ、ロック）、show_photoshop_panels（パネルの表示または非表示、初期設定ワークスペース、ヒストグラムパネルと情報パネルのオプション）、select_view_tool、edit_photoshop_guides（追加、ガイドレイアウト、シェイプから作成、ガイドまたはスライスを消去）
Camera Raw	open_raw_file（Camera Raw の設定とワークフローオプション）、apply_camera_raw_settings（Camera Raw フィルター：基本補正、カーブ、ディテール、カラーミキサー、カラーグレーディング、光学補正、効果、マスキング）、apply_neural_filter（深度ぼかし、スタイルの適用、写真を復元）、replace_sky、remove_background
生成	generative_fill、generate_image、harmonize_layer（Adobe アカウントとインターネット接続が必要です。生成クレジットを使用します）
ユーティリティ	photoshop_status、play_action、execute_photoshop_code、help
help({ tool }) は各ツールのパラメーターを説明します。

邪魔にならない仕組み

• ダイアログは表示されません。 すべてのスクリプトで displayDialogs がオフになるため、コマンドはクリックを待たずに設定を使用し、スクリプトが失敗した場合も含め、終了後に元の設定へ戻します。
• 単位は元に戻ります。 スクリプトはピクセル単位で動作し、終了後に定規と文字の単位を元に戻します。
• 書き出しでドキュメントは変更されません。 export_image と export_layers は一時的なコピーで処理を行い、そのコピーを閉じます。
• タイムアウトの理由がわかります。 Photoshop が PHOTOSHOP_SCRIPT_TIMEOUT_MS（既定値は 120 s）以内に応答しない場合、Photoshop でダイアログが開いている可能性があることをエラーで知らせます。
• スクリプトに生の入力は渡されません。 呼び出し側から渡された値はすべて検証され、リテラルとしてスクリプトに書き込まれます。

設定

変数	用途
PHOTOSHOP_APP_NAME	macOS：特定のコピーを指定します（例：Adobe Photoshop 2025）。既定では、サーバーはバンドル ID を使用して Photoshop を指定します。
PHOTOSHOP_ALLOWED_DIRS	ファイルを開く、保存する、書き出すための追加ディレクトリ（macOS では :、Windows では ; 区切り）。
PHOTOSHOP_SCRIPT_TIMEOUT_MS	Photoshop の応答を待つ時間。既定値は 120000 です。
PHOTOSHOP_BACKEND / PHOTOSHOP_TARGET	artcraft または photocraft に設定すると、ループバックの JSON 行経由でツール呼び出しを PhotoCraft にルーティングします。既定値は auto です（Adobe Photoshop が実行されていないとき、ポート 7878 で待ち受けていれば PhotoCraft にルーティングします）。
PHOTOCRAFT_CONTROL_PORT	PhotoCraft 制御チャネルのポート。既定値は 7878 です。
PHOTOCRAFT_CONTROL_TOKEN	必要な場合に PhotoCraft の認証に使用するトークン。

開発

npm test         # definitions, argument parsing, protocol, and the static script audit
npm run audit    # the audit alone, with findings listed
npm run check    # syntax check

監査では、スタブ化されたエグゼキューターに対してサンプル引数ですべてのツールを実行し、生成された各スクリプトが Photoshop のスクリプティングオブジェクトモデル（types-for-adobe、Photoshop 2015.5）に準拠しているかを確認します。現時点では、Photoshop 自体に対する検証は行いません。