GIMP

gimp-mcp

告诉 AI 助手你想做什么，然后看它在 GIMP 中实现。 gimp-mcp 可将 Claude、Codex、Cursor、VS Code 或任何其他 MCP 客户端连接到 你已打开的 GIMP 窗口：它会逐步打开文件、创建图层、设置可编辑文本、创建选区、应用 滤镜并导出，全程都在你眼前完成。

_{一段真实且未经剪辑的会话，播放速度为 2×：在 Claude Code 中输入一个提示词，其余工作都由 GIMP 通过 gimp-mcp 完成。高清视频（1080p，实时）。}

快速开始

gimp-mcp 可在 Linux、macOS 和 Windows 上运行。你需要 GIMP 3.2+、uv 和一个 MCP 客户端。在 Ubuntu 26.04 上：

sudo apt install -y gimp python3-gi gir1.2-gimp-3.0   # GIMP 3.2+ (other distributions and Flatpak: see below)
uvx gimp-mcp setup                                    # installs the GIMP plug-in, adds the server to your MCP clients
uvx gimp-mcp doctor                                   # after (re)starting GIMP: every check should be [ok]

然后告诉你的助手：“使用 GIMP 创建一张 1280×720 的图像，标题为‘Hello’，并将其导出到 ~/hello.png”。

• macOS 和 Windows：从 gimp.org 安装 GIMP 3.2，然后运行相同的 uvx gimp-mcp setup 和 uvx gimp-mcp doctor（安装说明）。
• Arch、Debian 14、Fedora 44、openSUSE Tumbleweed、Alpine 3.24 和来自 Flathub 的 GIMP：请参阅 兼容性说明。
• Claude Code、 Claude Desktop、 VS Code 和 Cursor 以及 任何其他 MCP 客户端（Codex、Zed…）的分步指南。
• 遇到问题？uvx gimp-mcp doctor 会说明问题所在以及如何修复 （故障排除）。

为什么选择 gimp-mcp

让你的 GIMP 即时响应。 助手会在你已打开的 GIMP 中工作，而不是在一个隐藏副本里。它添加的每个图层都会显示在图层面板中，你随时可以用鼠标接手操作。

结果可继续编辑。 标题会保留为可编辑的文本图层，每个步骤都可以放在单独的图层上，模糊和色彩校正可以作为可编辑滤镜，而 XCF 会保留所有这些内容。助手为你提供的是一个起点，而不是一张扁平化的 PNG。

它会检查自己的成果。 预览会以图像形式返回给模型，因此它可以查看结果、修正不理想之处，然后再导出。检查点让它可以尝试某个想法，并在效果不佳时回到较早的状态。

本地运行，安全可控。 不开放网络端口：使用只有你能打开的 Unix 套接字，每次启动 GIMP 都会生成新令牌，操作范围固定，并且只允许调用 GIMP 中经过许可的过程（不使用 eval，也不透传 Script-Fu）。详情请参阅安全模型。

一条命令即可完成设置。 gimp-mcp setup 会查找 GIMP（发行版软件包或 Flatpak），安装插件，并将服务添加到 Claude Code、Claude Desktop、VS Code 和 Cursor；修改任何文件前都会先征求同意。

可以提出的请求

• “打开 ~/Pictures/team.jpg，将它裁剪为居中的正方形，并导出一张 512 px 的头像。”
• “为我的博客文章 ‘Shipping on Fridays’ 制作一张 1200×630 的社交媒体卡片，使用深色背景，标题放在左侧。”
• “只提亮 poster.xcf 的背景图层，并保留下面的原图，将其隐藏。”
• “~/design/flyer.xcf 里有什么？列出图层、隐藏的图层和使用的字体。”
• “模糊 car.jpg 中的车牌，并在旁边保存一份副本。”

使用场景

通过 MCP 端到端完成的典型 GIMP 工作，每项工作都有一个在 Linux、macOS 和 Windows 上通过 CI 验证的脚本版本，以及一个评估套件中的 Agent 版本（一条自然语言请求）：

• 修复老旧扫描照片：拉直、裁剪扫描床区域、修复灰尘和划痕、恢复对比度、降低颗粒感，并生成用于打印的 16-bit TIFF （操作演示）。
• 网店商品照片：抠图且不丢失像素，在纯白背景上添加柔和阴影，裁剪为居中正方形，并生成三种尺寸的 JPEG 和 WebP，使用 sRGB 配置文件 （操作演示）。
• 社交媒体素材套件：将一个设计制作成四种格式（帖子、快拍、横幅、缩略图），并添加安全区域参考线和可编辑标题 （操作演示）。
• 教程截图：添加标注和箭头，将私人数据像素化到无法恢复，并移除元数据 （操作演示）。
• 网站照片：批量将文件夹中的照片转正、调整尺寸、添加水印、移除 GPS 信息，并导出 WebP 和 JPEG，同时报告损坏的文件 （操作演示）。
• 动态贴纸：制作带有帧时长和处置方式的帧，并在大小限制内生成优化的 GIF 和动态 WebP （操作演示）。
• 可直接打印的传单：制作 300 dpi 的 A5 文件，并添加出血、裁切和安全边距参考线，导出打印尺寸的 PDF 和 TIFF （操作演示）。
• YouTube 缩略图：使用一张照片制作，并添加可编辑标题 （指南）。

它能做什么

查看	列出打开的图像、检查图层树和项目、渲染模型可见的预览
文件	创建、打开、保存 XCF，按选项导出 PNG 和 JPEG，关闭
图层	添加、导入、复制、编组、调整顺序、重命名、不透明度、混合模式、可见性
形状	调整图像或画布大小、裁剪、缩放、旋转、翻转、移动
选择	矩形和椭圆选区（添加、减去、相交、羽化）、反选、图层蒙版
绘画	填充、线条和路径、矩形和椭圆
文本	可编辑的文本图层：字体、字号、颜色、对齐、间距
调整	亮度/对比度、色相/饱和度、模糊；可作为破坏性或可编辑滤镜
历史记录	撤销组（在 GIMP 中按一次 Ctrl+Z）和助手可还原的检查点
其他所有功能	约 420 个其他 GIMP 过程，可通过允许列表启用（procedures 工具集，选择启用）

共有 54 个工具，按工具集分组，让客户端 只加载所需内容：请参阅工具参考和 覆盖矩阵。

工作原理

 Claude / Codex / Cursor / …            gimp-mcp serve                 GIMP 3.2
 ───────────────────────────  MCP   ─────────────────────  Unix   ─────────────────────────
  "make the colors pop"      stdio   validates, maps ids  socket   gimp-mcp-bridge plug-in
                            ──────▶  to GIMP operations  ──────▶   runs them in your session

gimp-mcp setup 会将一个小型 Python 插件复制到你的 GIMP 配置文件中。GIMP 启动时会加载它，并在运行期间提供本地套接字服务。MCP 服务（由客户端启动的 uvx gimp-mcp serve）会与其通信。 也支持使用无头 GIMP 运行脚本和 CI。更多信息请参阅架构说明。

文档

• 安装参考（手动安装、升级、卸载）· MCP 客户端 · 故障排除 · 兼容性
• 工具参考 · 覆盖矩阵 · 脚本化演示操作指南
• 架构 · 桥接协议 · 安全 · 决策记录
• 测试 · 发布 · 录制演示视频 · GIMP 行为说明 · 更新日志

也已列入 MCP 官方注册表， 名称为 io.github.mhbxyz/gimp-mcp。采用 MIT 许可证。