1安装 imagic 并开始试用

MCP 服务器随 imagic Max 提供，500 次导出的免费试用会解锁全部功能，无需绑卡。请先从桌面版页面下载它，因为 Claude Code 需要有对象可以通信。

2把 imagic 添加到 Claude Code

双横线是必需的。没有它，Claude Code 会把 imagic 自己的参数当成它自己的。

claude mcp add imagic -- imagic-mcp

从本站安装了打包好的应用？那么你的电脑上没有 imagic-mcp 命令：应用本身就是服务器（以下以 Windows 为例；在 macOS 上是 /Applications/imagic.app/Contents/MacOS/imagic）：

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

配置

Claude Code 读取 .mcp.json（项目）或 ~/.claude.json（用户）。顶层键是 mcpServers。

{
  "mcpServers": {
    "imagic": {
      "type": "stdio",
      "command": "imagic-mcp"
    }
  }
}

从本站安装了打包好的应用？那么你的电脑上没有 imagic-mcp 命令：应用本身就是服务器。让 command 指向它，并传入 --mcp（以下以 Windows 为例；在 macOS 上命令是 /Applications/imagic.app/Contents/MacOS/imagic）：

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

这个文件在哪里

Windows	`%USERPROFILE%\.claude.json`
macOS	`~/.claude.json`
Linux	`~/.claude.json`

在界面中的位置

在会话里运行 /mcp，可以查看状态，并启用或停用服务器。

3要求选片

如果 Claude Code 已经在运行，请重启它，然后让它指向一场拍摄：

给 D:/Shoots/eva_tom 里的拍摄选片，套用我的风格，并导出留用照片。

Claude Code 会依次调用 scan_directory、analyze_photos、apply_my_style 和 export_photos。这些调用全部在你的电脑上运行：智能体发送指令，绝不发送你的照片。

容易出错的地方

作用范围在你添加服务器时就已确定。默认是 local，也就是只对当前项目有效；传入 --scope user 可以让 imagic 在所有地方都可用。
Anthropic 的文档明确指出，~/.claude/mcp.json 和 %APPDATA%\Claude\mcp.json 不会被读取。只有上面列出的路径会被读取。
项目范围的服务器在 Claude Code 第一次看到它时，需要你交互式批准。
手动编辑 .mcp.json 之后要重启会话；它是在会话开始时读取的。

连接之后 imagic 能做什么

scan_directory analyze_photos apply_my_style export_photos

一共 30 个工具，涵盖图库、选片、编辑和你学到的风格。见完整的工具参考，或者看工作流程了解该如何提要求。

要设置别的客户端？

Claude Desktop Cursor VS Code and GitHub Copilot Codex CLI Gemini CLI Windsurf (Devin Desktop)

在真实拍摄上试试

500 次导出的试用包含 imagic Max、MCP 服务器以及本页上的每个工具。无需绑卡。

开始免费试用阅读 MCP 指南

配置已对照 Anthropic 的文档核对。如果 Claude Code 更改了设置方式而本页没有跟上，请告诉我们，我们会修正。

把 imagic 连接到 Claude Code