Skip to main content
Glama
deenesjakoruzh
francisanderson

photoshop-mcp

by francisanderson
OverviewSchemaRelated ServersScoreDiscussions
JavaScript
Local

Photoshop MCP 服务器

一个模型上下文协议（MCP）服务器，让AI助手（Claude、opencode、Cursor等）能够通过ExtendScript + COM自动化在Windows上驱动Adobe Photoshop。

专为**Photoshop 2020（v21.x）**构建，但也兼容更新版本。提供约122个工具，涵盖文档、图层、文本、滤镜、颜色调整、选区与蒙版、图层样式、导出、布局分析、设计QA以及Photoshop状态检查。

非官方社区项目。与Adobe无关联，也未获其认可。

工作原理

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

  • ExtendScript，而非UXP — 通过COM进行外部自动化只能使用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） 和 Neural Filters 需要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