editmamei-photoshop-mcp

Editmamei

用自然语言解锁 Photoshop 照片编辑。 AI 编排，而非生成。

独立项目，与 Adobe Inc. 无关联，也未获其认可。

Editmamei 是一个用于操控桌面版 Adobe Photoshop 的模型上下文协议（MCP）服务。你用通俗语言描述编辑需求，AI 助手规划步骤，再由 Photoshop 使用标准调整图层、蒙版、选区和滤镜完成操作。AI 负责指挥，Photoshop 负责编辑。不会有生成模型接触你的像素，也不会为了执行编辑而上传图像。

无论是想通过对话编辑照片的摄影师和修图师，还是希望将 Photoshop 接入 AI 流程的开发者，都可以使用它。了解详情或立即开始，请访问 editmamei.com。

editmamei.com · 文档 · 报告错误

_{真实运行示例：73 张旅行照片，一句话，在 Photoshop 中完成调色。}

工作原理

Editmamei 是一个用 Node 编写的纯 MCP stdio 服务。你的 AI 客户端会将其作为子进程启动，并通过 stdio 调用其工具。每个工具都会生成一段小型 Photoshop 脚本，并通过平台原生自动化通道在本地 Photoshop 中运行：

AI client  ──stdio──▶  Editmamei (Node MCP server)
                              │  builds a Photoshop script per tool call
                              ▼
                    COM (Windows) / AppleScript (macOS)
                              │
                              ▼
                     Your local Adobe Photoshop

• Windows 通过 COM（Photoshop.Application 对象）操控 Photoshop。
• macOS 通过 AppleScript / OSA 操控 Photoshop。
• 感知（人脸、物体和场景检测）由本地 ONNX 计算机视觉模型在设备端运行，因此模型可以获取真实的文档坐标，而图像无需离开你的设备。

像素处理由 Photoshop 自身的引擎完成。Editmamei 是指挥者，而不是渲染器。

安装

npm install -g editmamei
editmamei install   # registers with Claude Desktop, Cursor, Claude Code
editmamei status    # confirms install state + Photoshop detection

然后重启 AI 客户端，并询问它：“Photoshop 已连接吗？”

不想使用终端？Claude Desktop 用户可以直接安装一键式 .mcpb 扩展（无需安装系统级 Node，Claude Desktop 自带运行时）。完整操作流程请参阅安装指南。

要求： Adobe Photoshop 2026（v27.x）、Windows 10/11 或 macOS 13+、Node.js 22+（使用 npm 安装时），以及兼容 MCP 的 AI 客户端（Claude Desktop、Cursor、Claude Code）。Editmamei 不附带自有模型，并使用你连接的客户端运行，因此每次编辑都会消耗该客户端的令牌。

完整会话流程

发现链依次为 ps_ping（存活检测）、ps_overview（工作方法和功能概览），然后是 tools/list（完整的、带有 schema 类型定义的工具清单）。之后，你只需与助手交流：

“打开我的度假照片。” “让天空更有戏剧感，但保持前景自然。” “锐化眼睛，柔化皮肤，其他部分保持原样。” “将主体单独提取到一个图层，并创建干净的蒙版。” “导出一张 2048px 的网页 JPEG。”

助手会将这些需求组合成工具调用，通过预览和测量结果进行检查，并不断迭代。

设计原则

这些选择塑造了工具界面，也让 AI 助手能够可靠地驱动它，而非寄希望于碰巧成功。

• 结构化结果，而非散文。 每个工具都会声明 outputSchema，并返回带类型的 JSON 负载。任何会改变当前活动对象的工具都会报告当前文档和图层，让模型在调用之间准确掌握 Photoshop 的状态，而不必重新推断。
• 引导融入工具界面。 ps_overview 会返回工作方法（评估、规划、执行、检查、迭代），ps_list_capabilities 则会返回实时功能清单。模型依据服务端信息确定方向，而非猜测或依赖过时的提示词。
• 用测量代替目测。 专用验证工具集（直方图、区域对比、图层边界差异、选区预览）让模型能够通过数值检查自己的工作，而不是只相信缩略图。
• 设备端感知。 本地计算机视觉（ONNX）可检测人脸、物体和场景区域，并返回真实的文档坐标。在此步骤中，图像会保留在你的设备上，绝不会发送给云端视觉模型。
• 默认采用非破坏性操作。 调整操作会创建调整图层，破坏性像素操作则会在自动创建的副本上运行。编辑本身就可以撤销。
• 经真实 Photoshop 验证。 每个工具都基于 Photoshop 自身的原生脚本函数构建，并在发布前通过 Photoshop 实时会话验证。新工具在通过实时验证之前会保持禁用，因此发布的工具界面就是经过验证的工具界面。
• 面向现代 Photoshop 构建。 Editmamei 面向 Photoshop 2026（v27.x），因此可以依赖当前稳定的脚本描述符，而不必沿用十年来不断偏离的行为。

工具概览

共 112 个工具。 Photoshop 工具集包含 83 个工具，分为 16 个功能组（62 个社区版工具，21 个专业版工具），按功能组覆盖工作流程，而非针对每项 Photoshop 功能单独提供一个工具。所有工具都使用 ps_* 命名空间，并可在运行时通过 tools/list 发现。两个版本都包含社区版工具；专业版工具需许可证才能解锁。除此之外，还有一个独立的编辑器工具集，可驱动无头 GIMP：29 个 gimp_* 工具，属于社区版，目前处于 beta 阶段，详见下文的 GIMP（beta）。专业版新增的工具仅适用于 Photoshop；GIMP 没有专业版。

分组	版本	工具
核心	社区版	ping · overview · list_capabilities · undo · redo · report_problem
检查	社区版	inspect · get_preview
验证	社区版	get_histogram · compare_regions · get_layer_bounds_diff · get_selection_preview
文档与画布	社区版	document · create_document · open_document · close_document · save_psd · export · place_image · resize_image · crop_document · convert_image_mode · transform_canvas · guides
选区	社区版	select · modify_selection · selection_channel
调整	社区版	add_adjustment_layer · apply_adjustment
滤镜	社区版	filter
修饰	社区版	retouch
图层	社区版	create_layer · delete_layer · fill_layer · add_fill_layer · select_layer · move_layer_to_position · duplicate_layer · copy_to_new_layer · convert_to_smart_object · rasterize_layer · set_layer · merge · bake_layer · add_layer_style · transform_layer · shape · group
蒙版与路径	社区版	layer_mask · clipping_mask · path · vector_mask · apply_image · calculations
文字	社区版	text
感知	社区版	detect · read_scene · select_by_reference
AI 选区	社区版	select_subject · select_sky · replace_sky
自动化	社区版	sequence
AI 选区	专业版	select_subject_instance · select_object
滤镜	专业版	apply_camera_raw · develop_raw
图层（变形）	专业版	warp_layer
感知	专业版	edit_object · add_text_to_object · resolve_placement
人脸网格	专业版	detect_landmarks · select_face_feature
模板	专业版	template_create_evidence · template_save · template_list · template_apply · template_verify · template_recall · template_delete
自动化	专业版	list_actions · play_action · execute_script · batch

GIMP（beta），独立的命名空间，所有工具均为社区版：

分组	版本	工具
GIMP	社区版（beta）	gimp_ping · gimp_overview · gimp_open_document · gimp_close_document · gimp_save_xcf · gimp_export · gimp_inspect · gimp_add_adjustment · gimp_add_effect · gimp_filter · gimp_bake · gimp_layer · gimp_transform_layer · gimp_text · gimp_select · gimp_modify_selection · gimp_layer_mask · gimp_get_selection_preview · gimp_create_document · gimp_place_image · gimp_canvas · gimp_convert_image_mode · gimp_crop_document · gimp_resize_image · gimp_transform_canvas · gimp_checkpoint · gimp_get_preview · gimp_get_histogram · gimp_compare

版本

• Community 免费，涵盖日常编辑所需功能：文档、图层、选区（包括 AI Select Subject 和 Select Sky）、非破坏性调整、滤镜、蒙版、文字、修饰、设备端感知，以及检查/验证基础功能。
• Pro 增加可重新编辑的 Camera Raw 滤镜、打开前处理的 raw 文件、文件夹批处理、可复现模板系统、精确定位工具（变形、命名对象蒙版、精确放置）、主体实例和人脸网格定位，以及 Photoshop Actions 和脚本扩展功能。

Pro 仅适用于 Photoshop 的升级版本：它不会为下文的 GIMP 功能增加任何内容。

详细的版本划分见 pro-features.md。价格信息见 editmamei.com。

此代码仓库包含 Community 源码。Pro 是单独授权的模块，其源码不会在此发布；Community 从不导入该模块，因此此代码树可以独立构建和运行。

GIMP（测试版）

Editmamei 也可以在无头模式下驱动 GIMP，作为 Photoshop 之外的第二个编辑器（或替代 Photoshop）。当检测到你的设备上安装了 GIMP 3.2+ 时，gimp_* 工具集会与 ps_* 工具集一同注册；你可以在指定使用 GIMP 时使用它，或者在 Photoshop 不可用时使用它。界面上不会显示窗口：编辑会在后台的 gimp-console 进程中进行，你可以在对话中查看渲染预览，而不是观察窗口变化。

测试版涵盖文档（打开、创建、保存 .xcf、导出）、图层和组、将一张照片置入另一张照片、13 种非破坏性调整类型和六种效果（暗角、黑白、动态模糊和镜头模糊、噪点、投影）、可附加为图层蒙版的选区（形状、色彩范围、魔棒、渐变）、实时文字图层、移动、缩放和旋转图层、裁剪/调整大小/旋转/翻转、扩展画布、颜色/灰度转换、可恢复的检查点，以及 Photoshop 端具备的相同预览/直方图/比较验证基础功能。目前尚不支持修复/仿制或 AI 主体和天空选区。完整详情、要求和故障排除说明见：docs/gimp.md。

从源码构建

git clone https://github.com/editmamei/editmamei.git
cd editmamei
npm install
npm run build
npm test

你需要 Node.js 22+ 和 Go 1.21+（构建过程会编译生成 Photoshop 脚本的 editmamei-core 二进制文件；它需要 Go 1.27，Go 会在 Go 1.21 及更高版本中为你下载该版本）。缺少 Go 时，构建会发出警告而不是失败，因此你仍可运行测试套件；如果不想安装 Go，可以将 EDITMAMEI_CORE_BIN 设置为预构建的二进制文件。

无需 Photoshop 即可运行测试套件。它会验证 Editmamei 生成的 ExtendScript，但不会验证 Photoshop 是否接受这些脚本，因此还需要另行在真实的 Photoshop 中进行实时验证。

欢迎贡献。请从 CONTRIBUTING.md 开始，其中介绍了 CLA、分支和拉取请求流程，以及错误报告应包含的内容。

配置

设置存储在 ~/.editmamei/settings.json 中，通过 editmamei config CLI 管理：

editmamei config list
editmamei config set telemetry.usage false      # turn off usage telemetry
editmamei config set ps_path "/path/to/Photoshop"

PHOTOSHOP_PATH（环境变量）可在单次运行中覆盖 Photoshop 自动检测结果。

隐私

Editmamei 在你的计算机上运行，并在桌面版 Photoshop 中进行编辑。不会向 Editmamei 的服务器发送任何图像内容、文档数据或文件路径。它会报告不含内容的使用情况遥测数据（默认启用，可通过 editmamei config set telemetry.usage false 关闭）。当你的 AI 助手需要查看结果时，Editmamei 会向其发送缩小尺寸后的预览，就像你把照片拖入与该助手的聊天中一样。所有字段都记录在 privacy.md 中，包括你的权利和法律依据。

此代码仓库中的源码与发布到 npm 的代码相同，因此上述内容无需靠信任来保证。

文档与支持

• 功能和定价： editmamei.com
• 安装： docs/installation.md
• 快速入门： docs/getting-started.md
• 常见问题： docs/faq.md
• AI 客户端： docs/clients.md
• 故障排查： docs/troubleshooting.md
• GIMP（测试版）： docs/gimp.md
• Pro 功能： docs/pro-features.md
• 路线图： docs/roadmap.md
• 错误和功能请求： 问题跟踪器。如果遇到问题，请让助手“报告问题”（或运行 editmamei report），将匿名诊断信息包保存到 Downloads 文件夹，然后将其附加到问题中。
• 安全： 请参阅 SECURITY.md（请勿公开提交安全问题）

许可证

Editmamei CE 是遵循 Functional Source License, v1.1, MIT Future License（FSL-1.1-MIT）的 Fair Source 软件。

你可以阅读、运行、修改和重新分发代码，用途几乎不受限制：商业照片编辑、内部工具、教育、研究和安全审查。该许可证仅限制一项用途：自每个版本发布之日起两年内，不得在与 Editmamei CE 或 Pro 竞争的商业产品或服务中向他人提供代码。如果你重新分发代码，请保留随附的许可证和版权声明。每个版本发布两年后，该版本将自动采用纯 MIT 许可证。

本节是通俗易懂的摘要。LICENSE 文件才是许可证正文；如有不一致，以 LICENSE 文件为准。

按照 OSI 的定义，Editmamei 并非开源软件，我们也不会这样称呼它。它是源代码可用的软件，完整的 CE 技术栈均以开放方式开发。

Editmamei Pro 是单独授权的商业模块；其源代码不公开发布。

第三方依赖遵循各自的许可证，详见 NOTICES.md。