如何用PhotoCraft MCP服务器让AI Agent自动修图从接入到10个Agent任务实战【免费下载链接】photocraftAn open-source, clean-room reimplementation of Adobe Photoshop in pure Rust项目地址: https://gitcode.com/gh_mirrors/pho/photocraftPhotoCraft 是一个用纯 Rust 编写的开源图像编辑器而它的MCP 服务器photocraft-cli mcp能让 AI Agent 直接驱动这台图像引擎打开 PSD、调色、加滤镜、打蒙版、导出 PNG——所有你手动能做的操作Agent 都能通过 MCP 工具自动完成。本文从接入到 10 个 Agent 修图任务实战完整带一遍。为什么 PhotoCraft 适合 AI Agent 自动修图PhotoCraft 的架构是引擎先行每一个菜单项、工具和对话框背后都是一个引擎命令UI、CLI、JSON 控制通道和MCP 服务器调用的是同一套 500 命令注册表。这意味着 凡是你能点到的功能Agent 都能执行 无需 Electron / 网页壳headless 会话直接跑在进程内command_list工具自带命令 ID 与参数文档Agent 可以自我发现能力️doc_render_preview把编辑结果渲染成 PNG 直接返回给 Agent形成编辑 → 看图 → 再调整的闭环两种接入模式Headless 与 BridgePhotoCraft MCP 服务器crates/automation/src/server.rs提供两种后端按需选择模式启动方式适用场景Headless默认photocraft-cli mcp批量处理、CI 流水线、无人值守编辑Bridgephotocraft-cli mcp --bridge 127.0.0.1:7878 --control-token-file token文件接管一个正在运行的桌面应用驱动实时界面Headless 模式下建议显式指定读写根目录把文件系统权限收敛到项目内photocraft-cli mcp --automation-read-root /work/project --automation-write-root /work/projectBridge 模式则先让桌面应用开启认证控制端口photocraft --control portMCP 客户端用同一个 token 文件完成认证。Bridge 模式下ui_*系列工具界面检查、截图、指针事件、菜单调用才可用。快速上手3 步完成 MCP 配置第 1 步克隆并构建git clone https://gitcode.com/gh_mirrors/pho/photocraft cd photocraft cargo build --release -p photocraft-cli第 2 步在 MCP 客户端中注册服务器以 Claude Code 为例把photocraft-cli mcp作为 stdio 服务器加入即可claude mcp add photocraft -- target/release/photocraft-cli mcp --automation-read-root /work/project --automation-write-root /work/project其他 MCP 客户端同理关键就三点传输方式选stdio启动命令是photocraft-cli mcp加上读写根目录参数。第 3 步让 Agent 说人话接入后你只需要自然语言下达指令例如打开 ./photos/001.psd加一个曲线调整层提亮中间调再叠一层自然饱和度导出 JPG质量 85。Agent 会通过command_list查到layer.newAdjustmentLayer.curves这类命令 ID 和参数文档再依次调用command_run执行——整个过程见下面的任务实战。10 个 Agent 修图任务实战以下 10 个任务来自项目的验收测试 crates/automation/tests/agent_tasks.rs——每个任务只用 MCP 工具doc_*、command_run等完全模拟真实 Agent 的工作方式#任务用到的关键命令1制作标题卡片文字层 投影导出 PNGtype.create、layer.layerStyle.dropShadow、doc_export2非破坏式调色曲线提亮 自然饱和度layer.newAdjustmentLayer.curves、layer.newAdjustmentLayer.vibrance3撤销/重做移除调整层再恢复一层edit.undo、edit.redo4可编辑模糊智能对象 高斯模糊随时调参layer.smartObjects.convertToSmartObject、filter.blur.gaussianBlur、layer.smartFilter.setParams5选区变图层蒙版椭圆区域显隐红色图层select.rect、edit.fill、layer.layerMask.revealSelection6选区存为通道再读回复用select.saveSelection、select.loadSelection7排布 3 个色块并左对齐layer.new.layer、layer.align.leftEdges8能力范围内的受控导出doc_export路径被限制在写根目录内9缩放后裁剪成方形image.imageSize、image.crop10印刷准备转 CMYK、原生保存并重新打开image.mode.cmyk、doc_save、doc_open任务示例标题卡片 投影Agent 的典型调用链工具调用参数均为 JSON这里简化展示# 新建画布 doc_new {width: 200, height: 120, background: white} # 建文字层 command_run {id: type.create, params: {x: 20, y: 70, text: Hello, size: 36}} # 加投影 command_run {id: layer.layerStyle.dropShadow, params: {distance: 4, size: 3}} # 导出 doc_export {path: card.png}任务示例非破坏式调色调色的关键在于调整层原始像素一个都不动随时可改、可关、可重排。# 曲线把中间调从 128 抬到 200 command_run {id: layer.newAdjustmentLayer.curves, params: {points: [[0,0],[128,200],[255,255]]}} # 自然饱和度 40 command_run {id: layer.newAdjustmentLayer.vibrance, params: {vibrance: 40, saturation: 0}}完成后用doc_inspect检查图层树会得到Adjustment / Adjustment / Pixel三层结构再edit.undo即可无损回退——任务 3 正是靠这个机制验证了撤销/重做闭环。一次调用跑多个命令command_batch步骤多时不必来回对话command_batch把多个命令合并成一次调用上限 2564 步实际 256 步默认遇错即停command_batch {steps: [ {id: layer.new.layer, params: {name: Red}}, {id: select.rect, params: {x: 16, y: 12, width: 32, height: 24, ellipse: true}}, {id: edit.fill, params: {color: #ff0000}}, {id: layer.layerMask.revealSelection} ]}返回值是{completed, failed, results:[...]}Agent 据此判断是否重试或调整参数。给 Agent 的 3 条实用建议先发现再执行command_list支持filter按 ID/名称模糊匹配和enabled_only别盲目调用命令✅每步验证doc_inspect返回完整图层树、历史、选区document.pixel命令可读取任意像素值做断言doc_render_preview最长边最大 2048px直接返回 PNG 让 Agent看图说话格式选对doc_save存.pcraft是无损原生格式增量保存.psd / .png / .jpg / .tif / .webp / .exr等扩展名则触发导出安全要点把 Agent 关进笼子PhotoCraft 的自动化安全模型book/src/automation/security-model.md内置了多重限制接入门槛低但边界清晰stdio 传输MCP 不打开任何网络监听端口只有启动时授权的客户端能通信读写根目录Agent 只能访问你授权的目录绝对路径和../越权访问会在生效前被拒绝测试 crates/automation/tests/mcp.rs 专门验证了这一点批量上限单次command_batch最多 256 步响应体 8 MiB 上限预览最长边 2048 像素Bridge 认证控制端口仅限 127.0.0.1 回环且要求 256 位 bearer tokentoken 不对则任何操作都发不出去⚠️ 注意token 证明的是持有凭证并不细分工具权限。生产环境建议用最小权限的操作系统账户运行不要把 MCP 暴露给不可信的中转服务延伸阅读想深入细节推荐按这个顺序读全部在仓库内自动化总览book/src/automation/overview.mdMCP 服务端与工具清单book/src/automation/mcp.mdCLI 子命令run/batch/serve/mcpbook/src/automation/cli.md桌面控制协议Bridge 模式的另一半docs/control-protocol.md10 任务验收测试源码crates/automation/tests/agent_tasks.rsMCP 工具测试含 Bridge 模式与路径安全crates/automation/tests/mcp.rs接上 PhotoCraft MCP 服务器你的 AI Agent 就获得了一双会修图的手10 个任务覆盖了从标题卡到印刷级的完整工作流。剩下的交给你的想象力。【免费下载链接】photocraftAn open-source, clean-room reimplementation of Adobe Photoshop in pure Rust项目地址: https://gitcode.com/gh_mirrors/pho/photocraft创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考