Gimp MCP Pro

GIMP MCP Pro

GIMP 3.0的生产级模型上下文协议服务器+

67种打字工具•可靠的沟通•人工智能友好的工作流程

GIMP MCP Pro允许AI助手（Claude等）通过结构良好、类型化的MCP工具来控制GIMP——创建图像、管理图层、绘制形状、应用滤镜、调整颜色等等。

特性

• 67种MCP工具 跨11个模块——图像管理、图层、选择、绘图、文本、转换、颜色、过滤器、检查、历史、PDB访问
• 可靠通信 --长度前缀套接字框架（不再猜测JSON边界）
• 持久连接 --一个TCP连接，保持活动状态，并自动重新连接
• GIMP 3.0.8兼容 --使用稳定的API（DrawableFilter、PDB程序）对当前GIMP版本进行测试
• 撤消组 --多步骤AI工作流作为一个撤销步骤
• Pydantic验证 --输入在到达GIMP之前经过验证
• AI引导提示 --最佳实践和迭代工作流文档
• 视觉验证 — get_image_bitmap 让AI看到它在画什么
• PDB发现 --搜索GIMP的数千个程序
• 安全舱口 — execute_python 适用于没有专用工具的任何东西

建筑

AI Assistant  ←→  MCP Server (gimp-mcp-pro)  ←→  GIMP Plugin
   (Claude)         stdio/SSE                      TCP socket
                    Typed tools                    PyGObject
                    Pydantic models                Native handlers

两个进程：MCP服务器在GIMP外部运行，并通过带有长度前缀帧的TCP与GIMP Python进程内部运行的插件通信。

快速开始

1.安装MCP服务器

pip install gimp-mcp-pro

或者从源代码安装：

git clone https://github.com/yourname/gimp-mcp-pro.git
cd gimp-mcp-pro
pip install -e .

2.安装GIMP插件

安装脚本会自动处理此问题：

./setup.sh

或者手动复制插件：

# Linux
PLUG_DIR="$HOME/.config/GIMP/3.0/plug-ins/gimp-mcp-pro"
mkdir -p "$PLUG_DIR"
cp gimp_plugin/gimp_mcp_plugin.py "$PLUG_DIR/gimp-mcp-pro"
chmod +x "$PLUG_DIR/gimp-mcp-pro"

# macOS
PLUG_DIR="$HOME/Library/Application Support/GIMP/3.0/plug-ins/gimp-mcp-pro"
mkdir -p "$PLUG_DIR"
cp gimp_plugin/gimp_mcp_plugin.py "$PLUG_DIR/gimp-mcp-pro"
chmod +x "$PLUG_DIR/gimp-mcp-pro"

3.在GIMP中启动插件

打开GIMP→ 工具 → 启动MCP Pro服务器

您应该在GIMP控制台中看到“MCP Pro：在localhost:9877上监听”。

4.配置克劳德桌面

添加到您的 claude_desktop_config.json:

{
  "mcpServers": {
    "gimp": {
      "command": "gimp-mcp-pro"
    }
  }
}

重新启动克劳德桌面。

5.开始编辑！

问克劳德： *“创建一个800x600的图像，中间有一个红色圆圈，下面有文字‘Hello World’”*

工具参考

图像管理（6个工具）

图层操作（9个工具）

绘图（9个工具）

选择（8个工具）

转换（11个工具）

颜色调整（13个工具）

滤镜和效果（8个工具）

检查（4个工具）

历史（3个工具）

高级（2个工具）

已知限制

• 取消/重做：GIMP 3.0的插件API不公开程序撤消/重做。使用 Ctrl+Z/Ctrl+Y 直接在GIMP中。撤销 *群组* 用于对AI操作进行分组。
• 投影：内部使用傅体；在某些设置中可能会导致连接问题。
• 字体名称：GIMP 3.0使用以下名称 Sans-serif, Serif, MonospaceThe add_text 该工具会自动映射常用别名。

环境变量

技术说明

筛选器实现

所有过滤器使用 Gimp.DrawableFilter 它将GEGL操作安全地封装在GIMP的插件上下文中。直接GEGL图构建(Gegl.Node())GIMP 3.0插件上下文中的崩溃——这是GIMP MCP Pro解决的一个已知限制。

颜色处理

颜色被接受为名称("red")，十六进制("#FF0000")，或CSS rgb("rgb(255,0,0)")所有工具。在内部，颜色使用Gegl。使用GIMP 3.0 API为对象上色。

连接协议

MCP服务器使用4字节大端长度前缀的JSON消息通过TCP与GIMP插件通信。这消除了早期实现中使用的脆弱的JSON边界检测。

发展

git clone https://github.com/yourname/gimp-mcp-pro.git
cd gimp-mcp-pro
pip install -e ".[dev]"
pytest

学分

基于以下见解：

• maorcc/gimp mcp --经过验证的GIMP插件架构，AI指导提示
• slliws/gimp-mcp服务器 --类型化工具模块结构
• libreearth/gimp-mcp --原始概念证明

许可证

麻省理工学院