Photoshop MCP Server

io.github.zachshallbetter由 GitHub 帳號 zachshallbetter 發布v0.1.0更新於 Oct 28, 2026

Drive Adobe Photoshop from any MCP client: layers, selections, adjustments, type and export.

已驗證STDIO僅桌面開發者工具媒體與設計

概覽

AI 產生的概覽

在本機驅動 Adobe Photoshop 的本地 MCP 伺服器，讓助理管理文件、圖層、選取範圍、調整、文字、匯出與自動化。

可以做什麼
  • 列出、新建、開啟、儲存、複製與關閉文件；管理最近使用檔案、中繼資料、註解與置入檔案
  • 調整影像與畫布尺寸、裁切、修剪、旋轉、平面化，並變更色彩模式與描述檔
  • 建立、排列、群組、變形、合併與刪除圖層；管理選取範圍、填色、筆畫與剪貼簿
  • 套用調整與濾鏡、調整圖層和填色圖層；繪製、修飾並設定筆刷與工具選項
  • 建立與排版文字圖層、列出字型，並處理視訊時間軸與影格動畫
  • 匯出影像、圖層與工作區域，列印，執行動作與批次處理，檢視與復原歷史記錄
適用情境
適合在已安裝 Photoshop 的桌面上，讓助理處理重複或腳本化的影像工作：批次編輯、圖層與匯出雜務、調整與濾鏡處理，或自動化動作與工作區域。
執行需求
透過 npx 以 stdio 在本機執行；需要 macOS 或 Windows 上的 Adobe Photoshop 2023 或更新版本，以及 Node.js 18 或更新版本。macOS 首次呼叫需授予自動化權限。選用變數：PHOTOSHOP_ALLOWED_DIRS、PHOTOSHOP_APP_NAME、PHOTOSHOP_SCRIPT_TIMEOUT_MS。
安裝前請注意
工具會變更目前文件，並可儲存、匯出、列印、結束 Photoshop 或執行腳本與動作，建議在副本上操作。檔案存取僅限家目錄及 PHOTOSHOP_ALLOWED_DIRS 中的目錄。生成式工具需要 Adobe 帳號與網路，並消耗生成額度。README 另列出 PhotoCraft 路由變數（含控制權杖），並說明腳本尚未針對 Photoshop 本身驗證。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Photoshop MCP Server，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

Photoshop MCP Server

An MCP server that drives Adobe Photoshop: documents, image and canvas size, layers and groups, selections, adjustments and filters, type, export and history. It runs on the machine where Photoshop is installed and talks to it through ExtendScript, the scripting interface Photoshop ships with.

Requires Photoshop 2023 or later on macOS or Windows, and Node.js 18 or later.

Install

Claude Code:

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

Any client that reads an mcpServers block (Claude Desktop, Cursor, Warp, …):

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

On macOS the first call asks for permission to control Photoshop (System Settings > Privacy & Security > Automation).

Conventions

  • Positions and sizes are pixels, measured from the document's top-left corner with y increasing downward, whatever ruler units you use.
  • Layers are chosen with target: { ids: [...] }, { names: [...] } or { active: true }. Ids are Photoshop's own layer ids; they come from list_layers and from every tool that creates a layer.
  • Colours are "#RRGGBB", "rgb(r,g,b)", "cmyk(c,m,y,k)", "gray(g)", "hsb(h,s,b)" or "lab(L,a,b)".
  • Adjustments, filters, fills and strokes change pixel layers, inside the selection when there is one.
  • Timeline times are { seconds, frames } at the timeline's frame rate.
  • Fonts are PostScript names; list_fonts finds them.
  • Files must be inside your home folder or a directory in PHOTOSHOP_ALLOWED_DIRS.

Tools

AreaTools
Documentslist_documents, get_document_info, create_document (with pixel aspect ratio, or with an artboard), open_document (any format Photoshop reads, optionally as a smart object; PDF, EPS, Photoshop Raw and DICOM with their open options), save_document (PSD, PSB, TIFF, PNG, JPEG, PDF, GIF, EPS, DCS 1.0 and 2.0, BMP, Targa, Pixar or Photoshop Raw, with each format's options; or a copy), duplicate_document, set_active_document, close_document, set_colors (foreground and background)
Filesmanage_recent_files (list, open, clear), close_documents (Close All), go_to_bridge, get_document_metadata and set_document_metadata (File Info and XMP), manage_document_notes (import, clear, Note tool, Notes panel), set_file_handling_preferences (image previews, recent files, History Log), place_file (Place Embedded or Linked, positioned, scaled and rotated)
Imageresize_image (Image Size: pixels, percent, resolution, resampling), resize_canvas (Canvas Size with an anchor), crop_image, trim_image, rotate_canvas (or flip), change_mode (colour mode and bit depth), convert_profile, flatten_image (or merge visible), reveal_all
Layerslist_layers, create_layer (pixel layer or group), set_layer_properties (name, opacity, fill, blend mode, visibility, locks), set_active_layer, arrange_layers, group_layers, ungroup_layers, duplicate_layers, delete_layers, merge_layers, transform_layers (move, scale, rotate, flip), rasterize_layers, link_layers, convert_background_layer, layer_comps
Selectionselect_area (rectangle, ellipse or polygon, combined with the current selection), select_all (all, none, inverse), modify_selection (expand, contract, feather, smooth, border, grow, similar), transform_selection, fill_selection, stroke_selection, save_selection (to or from an alpha channel), clipboard (copy, copy merged, cut, clear, paste, paste into)
Adjustments and filtersadjust_layers (brightness/contrast, levels, curves, exposure, vibrance, hue/saturation, colour balance, black & white, photo filter, channel mixer, gradient map, selective colour, shadows/highlights, posterize, threshold, desaturate, invert, equalize, auto tone, auto contrast, auto colour), apply_filter (blurs, sharpening, high pass, noise, median, dust and scratches, maximum, minimum, distortions, offset, clouds and more)
Adjustment and fill layerscreate_adjustment_layer (every adjustment type, with its settings, optionally clipped), edit_adjustment_layer, create_fill_layer (solid colour, gradient or pattern), edit_fill_layer
Colourswap_colors (or reset to black and white), pick_color (values in every colour model, web-safe colours), sample_color (Eyedropper and Color Sampler), define_pattern, assign_profile, set_color_preferences (colour settings, dynamic sliders, gamut warning opacity), set_proof_view (Proof Setup, Proof Colors, Gamut Warning)
Selectionselect_area (rectangle, ellipse or polygon, combined with the current selection), select_all (all, none, inverse), modify_selection (expand, contract, feather, smooth, border, grow, similar), transform_selection, fill_selection, stroke_selection, save_selection (to or from an alpha channel), clipboard (copy, copy merged, cut, clear, paste, paste into, paste in place, paste outside)
Adjustments and filtersadjust_layers (brightness/contrast, levels, curves, colour balance, photo filter, shadows/highlights, posterize, threshold, desaturate, invert, equalize, auto levels, auto contrast), apply_filter (blurs, sharpening, high pass, noise, median, dust and scratches, maximum, minimum, distortions, offset, clouds and more)
Painting and retouchingfill_contents (Edit > Fill: foreground, background, black, 50% gray, white, pattern, History, Content-Aware, and the scripted patterns Brick Fill, Cross Weave, Place Along Path, Random Fill and Symmetry Fill), draw_gradient (classic gradients with colour and opacity stops), stroke_path (paint along a path with the Brush, Pencil, Eraser, Clone Stamp, Healing Brush, Pattern Stamp, Dodge, Burn and other tools), fill_path, fill_at_point (Paint Bucket, Magic Eraser), set_tool_options (tool, brush preset, size, hardness, opacity, flow, mode, pressure buttons, Smoothing and its options, Mixer Brush Wet and Mix, Tolerance, Contiguous, painting cursors), set_brush_settings (the Brush Settings panel: tip shape, Shape Dynamics, Scattering, Texture, Dual Brush, Color Dynamics, Transfer, Brush Pose and the checkboxes), manage_brushes (import, export, Define Brush Preset, new, rename, delete and reset presets), set_clone_source_options (Clone Source panel: source, Reset Transform, overlay options), retouch_selection (Patch, Content-Aware Move)
Adjustments and filtersadjust_layers (brightness/contrast, levels, curves, colour balance, photo filter, shadows/highlights, posterize, threshold, desaturate, invert, equalize, auto levels, auto contrast, Auto Color Correction Options, Match Color, Replace Color), apply_filter (blurs, sharpening, high pass, noise, median, dust and scratches, maximum, minimum, distortions, offset, clouds, Lens Correction, Adaptive Wide Angle, Filter Gallery and more)
Painting and retouchingfill_contents (Edit > Fill: foreground, background, black, 50% gray, white, pattern, History, Content-Aware), draw_gradient (classic gradients with colour and opacity stops), stroke_path (paint along a path with the Brush, Pencil, Eraser, Clone Stamp, Healing Brush, Dodge, Burn and other tools), fill_path, fill_at_point (Paint Bucket, Magic Eraser), set_tool_options (tool, brush preset, size, hardness, opacity, flow, painting cursors), manage_brushes (import, export, Define Brush Preset), retouch_selection (Patch, Content-Aware Move)
Typecreate_text_layer (point or paragraph type), set_text (text, formatting, position, warp), list_fonts
Video and animationget_timeline, create_timeline (video timeline or frame animation, or convert), set_timeline (Timeline panel, frame rate, playhead, Animation Options), run_timeline_command (Move & Trim, split, work area, keyframes, onion skins, video layer frames), edit_frame_animation (new, delete, copy, paste, reverse and tween frames, frames to and from layers), add_video_layer, import_video_frames, set_clip_timing (in and out points, duration), add_video_transition, render_video
Historylist_history, undo (back, forward, or to a state), make_snapshot, edit_history (revert, delete or clear states, new document from a state, history brush source, purge), set_history_options (History Options and the History Log)
Automationlist_action_sets, edit_actions (new set, delete, clear, reset, load or save .atn), set_action_options (playback options, Button Mode, tool recording), run_action_batch (Batch), create_droplet, run_automate_command (Crop and Straighten Photos, Fit Image, Conditional Mode Change, Lens Correction, Delete All Empty Layers, Flatten All Layer Effects, Flatten All Masks), combine_images (Load Files into Stack, Photomerge, Merge to HDR Pro, Statistics), manage_script_events (Script Events Manager), manage_data_sets (import, apply and export variable data sets)
Artboardsget_artboards, create_artboard (new, from layers, from a group, or an artboard document), edit_artboards (size, position, background, auto-nesting, duplicate, ungroup, guides, Artboard and Frame tools), create_frame (from layers or a group), export_artboards (to files or one PDF)
Exportexport_image (Save for Web: PNG, PNG-8, JPEG, GIF, optionally resized), export_layers (one file per layer or group), quick_export (the document or chosen layers), export_layer_comps (to files or one PDF), export_paths_to_illustrator, make_pdf_presentation (multi-page PDF or slideshow), generate_image_assets (Generator asset layer names, defaults layer, on or off)
Printget_print_options, set_print_options (printer, copies, colour handling and separations, print space, position and scale, marks, functions), print_image (with the settings, or one copy), apply_trap
Historylist_history, undo (back, forward, or to a state), make_snapshot
Applicationget_photoshop_info (version, memory, System Info, file types, feature checks), get_photoshop_preferences, set_photoshop_preferences (general, interface and colour theme, file handling, performance, cursors, transparency, units and rulers, guides and grid, plug-ins, type, script dialogs), purge_photoshop_caches, run_photoshop_command (beep, bring to front, refresh, hide, Help, account), run_photoshop_menu_item, manage_script_options (values kept between sessions), quit_photoshop
Interfacearrange_photoshop_windows (tile, 2-up to 6-up, tabs, float, match zoom and location), set_zoom_and_screen_mode, toggle_view_extras (extras, show items, rulers, snapping, locks), show_photoshop_panels (show or hide panels, Essentials workspace, Histogram and Info panel options), select_view_tool, edit_photoshop_guides (add, guide layout, from shape, clear guides or slices)
Camera Rawopen_raw_file (Camera Raw settings and workflow options), apply_camera_raw_settings (Camera Raw Filter: Basic, Curve, Detail, Color Mixer, Color Grading, Optics, Effects, Masking), apply_neural_filter (Depth Blur, Style Transfer, Photo Restoration), replace_sky, remove_background
Generativegenerative_fill, generate_image, harmonize_layer (need an Adobe account and an internet connection; use generative credits)
Utilityphotoshop_status, play_action, execute_photoshop_code, help

help({ tool }) describes any tool's parameters.

How it stays out of your way

  • No dialogs. Every script runs with displayDialogs off, so a command uses its settings instead of waiting for a click, and restores your setting afterwards, even when the script fails.
  • Your units come back. Scripts work in pixels and restore your ruler and type units afterwards.
  • Exports don't touch the document. export_image and export_layers work on a temporary copy and close it.
  • Timeouts say why. If Photoshop does not answer within PHOTOSHOP_SCRIPT_TIMEOUT_MS (default 120 s), the error says a dialog is probably open in Photoshop.
  • No raw input in scripts. Every value a caller passes is validated and written into the script as a literal.

Configuration

VariablePurpose
PHOTOSHOP_APP_NAMEmacOS: address a specific copy, e.g. Adobe Photoshop 2025. By default the server addresses Photoshop by its bundle id.
PHOTOSHOP_ALLOWED_DIRSExtra directories for opening, saving and exporting files (:-separated on macOS, ; on Windows).
PHOTOSHOP_SCRIPT_TIMEOUT_MSHow long to wait for Photoshop. Default 120000.
PHOTOSHOP_BACKEND / PHOTOSHOP_TARGETSet to artcraft or photocraft to route tool calls to PhotoCraft via loopback JSON-lines. Default auto (routes to PhotoCraft if listening on port 7878 when Adobe Photoshop is not running).
PHOTOCRAFT_CONTROL_PORTPort for PhotoCraft control channel. Default 7878.
PHOTOCRAFT_CONTROL_TOKENToken for PhotoCraft authentication if required.

Development

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

The audit runs every tool with sample arguments against a stubbed executor and checks each generated script against Photoshop's scripting object model (types-for-adobe, Photoshop 2015.5). Nothing is validated against Photoshop itself yet.

來源：packages/photoshop/README.md，提交 44b5b50

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包，因此其工具未知。

版本歷史

1
  1. v0.1.0最新Oct 20, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手；SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分