Skip to main content
Glama
deenesjakoruzh
francisanderson

photoshop-mcp

by francisanderson
OverviewSchemaRelated ServersScoreDiscussions
JavaScript
Local

Photoshop MCP サーバー

AIアシスタント（Claude、opencode、Cursor など）が ExtendScript + COM オートメーションを通じて Windows 上の Adobe Photoshop を操作できるようにする Model Context Protocol (MCP) サーバーです。

Photoshop 2020（v21.x） 向けに構築されていますが、新しいバージョンでも動作します。ドキュメント、レイヤー、テキスト、フィルター、色調補正、選択範囲とマスク、レイヤースタイル、書き出し、レイアウト解析、デザインQA、Photoshop の状態調査など、約122のツールを備えています。

非公式のコミュニティプロジェクトです。Adobe とは提携しておらず、Adobe による推奨も受けていません。

仕組み

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

  • UXP ではなく ExtendScript — COM による外部オートメーションは ExtendScript のみ使用できます。ExtendScript はすべての Photoshop バージョン（2012〜2025+）で動作します。UXP はインプロセスプラグイン用であり、外部から呼び出すことはできません。

  • Unicode 対応 — 非 ASCII テキスト（例：£、—）は生成された JSX 内で \uXXXX にエスケープされ、UTF-8 BOM が先頭に付加されるため、価格やアクセント記号なども正しく往復します。

  • ビジー時の再試行 — 一時的な COM エラー RPC_E_SERVERCALL_RETRYLATER（「アプリケーションがビジーです」）は、バックオフ付きで再試行されます。

Related MCP server: ImageMcp

要件

  • Windows

  • Adobe Photoshop がインストールされていること（PS 2020 / v21.2 でテスト済み）

  • Node.js 18 以上

インストール

npm install

MCP サーバーとして構成

MCP クライアントの設定（例：~/.config/opencode/opencode.jsonc、Claude Desktop、Cursor）に追加します：

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

変更後は MCP クライアントを再起動して、更新されたツールリストを読み込んでください。

主なツール

分野

ツール

ドキュメント

create_document、open_image、save_psd、export_image、export_as、crop_document、resize_image、close_document、generate_variants

レイヤー

create_layer、add_text、add_text_box、add_rectangle、add_image、place_image、duplicate_layer、delete_layer、rename_layer、rasterize_layer、group_layers、merge_visible_layers、flatten_image、不透明度 / 描画モード / 表示・ロック

レイヤー操作

move_layer、resize_layer、rotate_layer、move_layer_up/down/to_position、fit_layer_to_document、align_layers、distribute_layers、center_in_canvas、snap_to_safe_area

テキスト

list_fonts、check_font_available、set_font、set_color、set_text_alignment、update_text_content、fit_text、fit_text_to_box

フィルター

apply_gaussian_blur、apply_sharpen、apply_noise、apply_motion_blur

カラー

adjust_brightness_contrast、adjust_hue_saturation、auto_levels、auto_contrast、desaturate_layer、invert_layer、adjust_curves、apply_lut、adjust_vibrance、adjust_exposure、apply_photo_filter、apply_gradient_map

選択範囲とマスク

select_rectangle、select_all、deselect、invert_selection、create_layer_mask、delete_layer_mask、apply_layer_mask、apply_gradient_mask、content_aware_fill

レイヤースタイル

apply_layer_style（ドロップシャドウ / 光彩（外側）/ 境界線）

履歴

undo、redo、get_history、save_checkpoint、restore_checkpoint

レイアウト / QA

analyze_layout、detect_overlaps、validate_layout、design_qa、visual_hierarchy、brand_check、execute_design_plan、apply_constraints

デザインシステム

save_design_system、load_design_system、list_design_systems、capture_design_system、create_component

状態調査

get_version、get_capabilities、get_state、get_session_info、get_active_document_info、get_selection_info、get_document_info、list_layers、get_layer_bounds、get_preview、render_preview

データ駆動

image_stack、list_datasets、import_datasets、generate_from_datasets

自動化

play_action、execute_script

MCP クライアントで tools/list を実行すると、全約122ツールを確認できます。

設定リファレンス

run/

一時 JSX ファイル（自動作成）

snapshots/

ビジュアルリグレッション用の名前付き PNG スナップショット（render_snapshot）

checkpoints/

ロールバック用の PSD バックアップ（save_checkpoint）

design-systems/

保存済みデザインシステム（save_design_system）

既知の制限事項

  • 生成 AI（Firefly） と ニューラルフィルター は PS 24 以降 / UXP ブリッジプラグインが必要なため、ExtendScript からは操作できません。

  • select_subject は PS 23 以降が必要です。export_as の WebP/AVIF は PS 23.2 以降が必要です。

  • PS 2020 では、モーダルダイアログが開いていると「Photoshop がビジーです」と表示される場合があります。その場合はダイアログを閉じて再試行してください。

クレジット

機能設計は以下に触発されています：

どちらも MIT ライセンスです。このプロジェクトは、追加ツール（レイアウト解析、デザインQA、デザインシステム、ビジュアルリグレッション）を備えた独立した実装です。

ライセンス

MIT

This server cannot be installed

A
license - permissive license
Not graded
quality - not tested
C
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
–Release cycle
–Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

  • ImageMcp

    dotlab-hq
    F
    license
    Not graded
    quality
    C
    maintenance
    A full-featured image processing MCP server for AI assistants, exposing ~55 tools across 11 categories for editing, layers, conversion, AI segmentation/cleanup/generation, design analysis, and screenshot-to-code.

  • Illustrator MCP

    jinkeda
    A
    license
    Not graded
    quality
    D
    maintenance
    An MCP server that lets AI assistants like Claude control Adobe Illustrator through natural language by executing ExtendScript code and providing document state inspection.
    6
    MIT

View all related MCP servers

Related MCP Connectors

  • Figma MCP Server

    The Figma MCP server brings Figma design context directly into your AI workflow.

  • hithereiamaliff-mcp-nextcloud

    A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…

  • slima

    MCP Server for Slima - AI Writing IDE for Novel Authors with AI Beta Reader.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/francisanderson/photoshop-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server