1安装 imagic 并开始试用

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

2把 imagic 添加到 Amazon Q Developer

CLI 会替你写好文件，这样就绕开了下面说的两个文件的混乱。

q mcp add --name imagic --command imagic-mcp

配置

Amazon Q Developer 读取 ~/.aws/amazonq/mcp.json（全局）或 .amazonq/mcp.json（工作区）。顶层键是 mcpServers。

{
  "mcpServers": {
    "imagic": {
      "command": "imagic-mcp",
      "args": []
    }
  }
}

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

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

这个文件在哪里

macOS	`~/.aws/amazonq/mcp.json`
Linux	`~/.aws/amazonq/mcp.json`

AWS 只以 ~ 形式公布了这个路径，也没有说明 Windows 上如何展开，所以请使用上面的命令或界面，不要猜它落在哪里。

在界面中的位置

依次选择 Amazon Q Developer 面板、Chat、工具图标，然后点加号。

3要求选片

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

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

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

容易出错的地方

AWS 正处于两个文件之间的迁移过程中。IDE 现在写入 default.json，而 mcp.json 仍可通过 useLegacyMcpJson 设置继续使用，该设置默认为 true。CLI 读取的是 mcp.json。
当工作区配置和全局配置都写了同一个服务器时，以工作区配置为准。
timeout 字段的单位是毫秒，默认值是 120000。
AWS 只用波浪号形式记录这些路径，没有 Windows 下的展开写法。

连接之后 imagic 能做什么

scan_directory analyze_photos apply_my_style export_photos

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

要设置别的客户端？

ChatGPT Claude.ai Claude Code Claude Desktop Cursor VS Code and GitHub Copilot

在真实拍摄上试试

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

开始免费试用阅读 MCP 指南

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

把 imagic 连接到 Amazon Q Developer