- 安装 photocraft-cli. 从官方 Release 安装 PhotoCraft；macOS 还要单独下载命令行 zip。
- 选一个工作文件夹. 建一个允许智能体读写的文件夹。
- 注册 MCP 服务. 运行 claude mcp add photocraft -- photocraft-cli mcp，并用 --automation-read-root 和 --automation-write-root 指向这个文件夹。
- 让智能体干活. 让智能体在这个文件夹里打开、编辑、导出图片。
能用来做什么
- 让智能体给一整个文件夹的照片调色、改尺寸或加水印，再保存结果。
- 用脚本查看 PSD 的图层树、蒙版和历史记录。
- 渲染预览图，让智能体自己看效果、反复调整。
- 在 CI 或服务器上无界面批量处理图片。
第 1 步：拿到 photocraft-cli
- Windows（MSI）：装在 C:\Program Files\PhotoCraft\photocraft-cli.exe，没有加入 PATH。
- Linux（.deb 或 .rpm）：装在 /usr/bin/photocraft-cli。
- macOS：单独下载 photocraft-cli-<版本>-macos-universal.zip。.app 里只有桌面编辑器。
第 2 步：添加到 Claude Code
先选一个允许智能体使用的工作文件夹，再注册服务。下面的命令来自 PhotoCraft 官方 MCP 文档：
命令
# macOS (CLI unzipped onto PATH) or Linux (.deb/.rpm)
claude mcp add photocraft -- photocraft-cli mcp \
--automation-read-root ~/Pictures/photocraft \
--automation-write-root ~/Pictures/photocraft
# Windows, default MSI install folder
claude mcp add photocraft -- "C:\Program Files\PhotoCraft\photocraft-cli.exe" mcp --automation-read-root C:\Users\you\Pictures\photocraft --automation-write-root C:\Users\you\Pictures\photocraftClaude Desktop 和其他 MCP 客户端
用 JSON 配置的客户端，命令和参数是一样的：
命令
{
"mcpServers": {
"photocraft": {
"command": "photocraft-cli",
"args": [
"mcp",
"--automation-read-root", "/Users/you/Pictures/photocraft",
"--automation-write-root", "/Users/you/Pictures/photocraft"
]
}
}
}服务提供的工具
command_list | 列出命令 id、参数说明，以及当前是否可用。 |
|---|---|
command_run | 按 id 执行一个命令，可以带参数。 |
command_batch | 按顺序执行多个步骤，每一步都是一条历史记录。 |
doc_inspect | 返回当前文档的图层树、历史记录和选区。 |
render_preview | 返回 PNG 预览图，长边最大 2048 像素。 |
ui_inspect、ui_screenshot | 查看和截取正在运行的软件窗口（仅桥接模式）。 |
可以试试的提示词
连上服务后，像平常一样跟智能体说话就行：
- “打开 portrait.psd，列出所有图层，告诉我哪些是隐藏的。”
- “加一个曲线调整图层，把暗部稍微提亮，然后导出一张 50% 尺寸的 JPEG 预览。”
- “把 raw/ 里每张 JPEG 做一次自动色调，PNG 副本存到 graded/。”
- “渲染一张预览，自己看一下，哪里锐化过头就改掉。”
桥接模式：控制正在运行的软件
无界面模式用的是独立的引擎。想让智能体在你打开的窗口里操作、还能看到界面，就用控制通道启动桌面版，再桥接过去：
命令
# 1. Start the desktop app with its control channel.
# PhotoCraft creates the token file (a fresh 256-bit token) if it doesn't exist.
photocraft --control 7878 --control-token-file ~/.config/photocraft-control.token
# 2. Point the MCP server at the running app with the same token file
photocraft-cli mcp --bridge 127.0.0.1:7878 --control-token-file ~/.config/photocraft-control.token不用智能体：直接用命令行
同样的命令也可以在终端或脚本里直接运行：
命令
# Headless: open, edit, save
photocraft-cli run wave.psd \
--cmd filter.sharpen.smartSharpen --params '{"amount":80}' \
--cmd layer.newAdjustmentLayer.curves --params '{"points":[[0,0],[64,48],[192,212],[255,255]]}' \
--out wave-final.png
# Apply one action list to a folder of images
photocraft-cli batch --actions grade.json --in ./raw --out ./graded
# Every subcommand explains itself
photocraft-cli batch --help安全提醒
- stdio 方式的 MCP 不开网络端口，客户端只能访问启动时授权的文件夹。
- 桌面版的控制通道只绑定本机回环地址，并且需要令牌。令牌文件要保密，不要提交到代码仓库，也不要写进日志。
- 目前服务还不区分只读文档的工具和影响大的工具。不要通过不可信的中转、代理或远程服务暴露它。
book/src/automation/mcp.md · docs/control-protocol.md
常见问题
PhotoCraft 有 MCP 服务吗？
有。photocraft-cli mcp 会启动一个 stdio MCP 服务，可以无界面运行，也可以桥接到正在运行的桌面版。每个版本都自带。
哪些 AI 工具能用 PhotoCraft 的 MCP 服务？
任何能启动 stdio 服务的 MCP 客户端都可以，包括 Claude Code 和 Claude Desktop。PhotoCraft 文档里给的就是 claude mcp add 的命令。
为什么智能体提示没有权限、访问不了文件？
启动服务时要加 --automation-read-root 和 --automation-write-root，并且只能用这两个文件夹里的路径。不加的话，文件操作会直接被拒绝。
Photoshop 能这样用吗？
Photoshop 有动作、脚本和 UXP 插件，但没有内置 MCP 服务。有第三方做的桥接，而 PhotoCraft 是原生开放所有命令。
Windows 上有 photocraft-cli 吗？
有。MSI 会把 photocraft-cli.exe 装在 C:\Program Files\PhotoCraft，和主程序放在一起。它不在 PATH 里，需要用完整路径。