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 分