imagic

imagic MCP 服务

首款内置 MCP 服务的照片编辑器。

imagic 是一款适用于 Windows 和 macOS 的桌面照片编辑器，提供 AI 筛选、完整的非破坏性编辑器和风格学习功能。它的 MCP（Model Context Protocol）服务内置于应用中，因此 Claude Code、Claude Desktop、Cursor、Codex、GitHub Copilot 或任何其他 MCP 客户端都可以驱动整个工作流程：扫描拍摄内容、筛选照片、按你的风格编辑，并导出精选照片。所有操作都在你的设备本地运行。

此代码库是该服务的文档和设置参考。服务本身包含在 imagic 桌面应用中；此处不提供单独的服务源代码。

• 完整指南：imagic.ink/mcp
• 不使用 AI 客户端进行脚本编写：imagic.ink/automation
• 下载：imagic.ink/desktop

Agent 可以用它做什么

连接后，Agent 会调用你在应用中手动触发的相同操作。你可以直接这样说：

• “扫描 D:/Shoots/june-wedding，筛选照片，并告诉我你保留了哪些以及原因。”
• “让精选照片色调更暖，并将它们导出到 D:/delivery。”
• “把我的胶片预设应用到黄金时段拍摄的照片上。”
• “像我平时那样编辑整组拍摄内容。”（完成风格校准后）
• “我编辑了这场婚礼的 5 张照片，把其余照片调整得与它们一致。”
• “其实，只保留最好的 60 张，供客户制作相册。”（即时重新排序，无需重新分析）
• “将精选照片导出为全分辨率 JPEG。”

编辑会作为非破坏性调整保存在 imagic 的编辑历史中，与手动编辑相同。除非你明确选择导出，否则不会覆盖原始文件。

安装

1. 从 imagic.ink/desktop 下载 imagic。免费试用版包含 imagic Max 的全部功能，可导出 500 次，无需银行卡（导入、筛选和编辑均不计入次数）。
2. 启动应用一次并激活（试用版或许可证均可）。MCP 服务会使用相同的激活状态。
3. 连接你的 MCP 客户端（见下文）。

该服务就是 imagic 应用本身，通过 --mcp 启动。打包应用中没有 pip 包，也没有单独的 imagic-mcp 命令；请将客户端指向已安装的二进制文件：

• Windows：C:\Program Files\imagic\imagic.exe
• macOS：/Applications/imagic.app/Contents/MacOS/imagic

十四种客户端的单独设置说明（配置文件位置及对应的配置键）见 imagic.ink/mcp/setup。

Claude Code

claude mcp add imagic -- "C:\Program Files\imagic\imagic.exe" --mcp

在 macOS 上：

claude mcp add imagic -- /Applications/imagic.app/Contents/MacOS/imagic --mcp

Claude Desktop、Cursor 及其他 JSON 配置客户端

将以下内容添加到客户端的 MCP 配置中（Claude Desktop 使用 claude_desktop_config.json）：

{
  "mcpServers": {
    "imagic": {
      "command": "C:\Program Files\imagic\imagic.exe",
      "args": ["--mcp"]
    }
  }
}

在 macOS 上，使用 "command": "/Applications/imagic.app/Contents/MacOS/imagic"，并保持 "args": ["--mcp"] 不变。

Codex CLI

codex mcp add imagic -- "C:\Program Files\imagic\imagic.exe" --mcp

或者，在 ~/.codex/config.toml 中添加：

[mcp_servers.imagic]
command = 'C:\Program Files\imagic\imagic.exe'
args = ["--mcp"]

GitHub Copilot 和其他任何兼容 MCP 的客户端也采用相同方式：使用 imagic 二进制文件并附带 --mcp 命令的本地 stdio 服务。

21 个工具

工具	功能	可以这样说
scan_directory	将文件夹中的 RAW 和 JPEG 编入素材库。	“扫描 D:/Shoots/june-wedding，告诉我里面有什么。”
list_photos	按状态筛选照片，每页列出照片及其评分。	“列出这次拍摄中所有保留的照片。”
get_photo	获取单张照片的完整记录、评分和元数据。	“关于 _MG_2041.CR3，分析结果是什么？”
get_library_stats	统计拍摄级别的数量、保留率和筛选进度。	“这次拍摄的筛选进度如何？”
analyze_photos	评估锐度、曝光、噪点、构图和细节，并标记重复照片和连拍照片。	“给所有照片评分，并标记值得保留的照片。”
set_photo_status	覆盖单张照片的决定：保留、丢弃或恢复为未决定。丢弃不会删除文件。	“保留第 12 张，丢弃第 15 张。”
reselect_photos	立即重新排列值得保留的照片，无需重新分析。支持 Top-N 作品集模式。	“还是只保留最好的 150 张吧。”
check_score_freshness	报告有多少已存评分来自较旧版本的 AI 评分器。	“这里有评分过期的照片吗？”
reanalyze_stale_photos	仅重新评估由较旧评分器评过的照片；不会更改你的手动选择。	“重新评估评分过期的照片。”
apply_adjustments	对单张或批量照片进行曝光、色彩、裁剪等完整调整。	“稍微提亮仪式照片的阴影。”
list_presets	列出你的 imagic 安装中保存的所有预设，供 Agent 查看。	“我有哪些预设可以用？”
apply_preset	将任意已保存的预设批量应用到选定照片。	“把我的胶片预设应用到黄金时段拍摄的照片上。”
get_photo_edits	查看应用于任意照片的非破坏性编辑步骤。	“这个文件目前做了哪些编辑？”
start_style_calibration	开始引导式风格校准，最多可从素材库中选择 8 张照片。	“我们来教你我怎么修图。”
record_style_calibration	在你进行每项校准编辑时保存设置。	“这张修好了，记住这些选择。”
get_style_profile	查看校准过程对你的偏好有何了解。	“描述一下你认为我的修图风格。”
apply_my_style	按照你的修图方式编辑任意一组照片。	“按我的风格编辑整组照片。”
learn_style_from_library	使用你在 imagic 中修过的所有照片训练风格配置。	“从我修过的所有照片中学习我的风格。”
match_style_from_examples	编辑拍摄中的几张照片，让其余照片匹配这种风格，而不更改你保存的风格配置。	“我修了这场婚礼中的 5 张照片，让其余照片也匹配它们的风格。”
export_photos	按指定格式和尺寸批量导出值得保留的照片；如果批量导出中途被中断，可以继续。	“将值得保留的照片导出为全分辨率 JPEG。”
get_preview_url	提供本地实时预览页面的链接，展示 Agent 正在进行的操作。	“让我看看你在做什么。”

风格学习：从 8 张照片开始，用所有照片训练

imagic 的风格工具让 Agent 驱动的编辑更具个性，而非千篇一律：

1. 循序渐进地开始，使用 8 张照片。 start_style_calibration 会从你的个人图库中提取最多 8 张场景照片，涵盖多种光线和拍摄主体。按照自己的方式在 imagic 中编辑它们，record_style_calibration 会保存每项选择，几分钟内即可创建第一个风格档案。
2. 它会读取你实际做出的选择。 你在 imagic 中设置的实际曝光、色彩和裁剪数值会按场景记录，并用于生成专属于你的风格档案。你可以随时使用 get_style_profile 查看档案。
3. 然后用所有照片训练。 每当你的审美发生变化，都可以重复训练；也可以将 learn_style_from_library 用于你的历史图库：你曾在 imagic 中编辑过的每张照片都会用于训练风格档案。随后，apply_my_style 就能按照你的风格编辑今后的任何一次拍摄。

在同一次拍摄中，你还可以先编辑几张，再让其余照片匹配风格：手动编辑几帧，然后用 match_style_from_examples 让剩余照片匹配该效果，同时不更改已保存的风格档案。

坦诚说明其能力边界：它会读取你在 imagic 中设置的实际调整数值，从编辑结果中学习。它无法根据导出的 JPEG 或 Lightroom 目录推测你的风格。

隐私

MCP 服务在本地与 imagic 一同运行，并通过你自己的设备与你的 AI 客户端通信。Agent 会发送工具调用和指令；你的照片绝不会上传到任何地方。所有扫描、评分、编辑和导出都在你的硬件上完成，与直接使用 imagic 一样。

许可

MCP 服务和无头 CLI 均属于 imagic Max（99 欧元，一次性付费，无订阅）。imagic 的付费套餐起价为 19 欧元；Lite 和 Plus 可运行完整的 GUI，但不支持无头或 MCP 自动化。免费试用版包含完整的 Max 权限，可导出 500 张照片，包含 MCP 和 CLI，无需提供银行卡。

使用无头功能和 MCP 需要已激活的桌面许可证：启动一次 GUI，使用试用版或许可证密钥激活后，MCP 服务会复用该激活状态。

链接

• imagic.ink/mcp：完整的 MCP 和 CLI 指南、各客户端的设置说明及常见问题
• imagic.ink/automation：全部三种自动化方式（应用内批量工具、无头 CLI、MCP）
• imagic.ink/desktop：下载和免费试用

---

imagic 是一款闭源商业应用。本文件版权归 imagic 所有。欢迎引用和链接到本文档，包括在 MCP 目录和注册表中。