关键词

GIMP集成AI图像编辑图像自动化图像元数据视觉AI工具

项目简介

GIMP MCP服务器是一个创新的项目，它将强大的GIMP图像处理软件与模型上下文协议（MCP）集成，允许AI助手（如Claude Desktop、Gemini CLI等）通过自然语言或结构化指令直接控制GIMP。无论是简单的图像调整还是复杂的多步工作流程，GIMP MCP都能将其转化为精确的GIMP操作，极大地降低了非技术用户使用GIMP的门槛，并提升了专业人士的工作效率。此外，它支持MCP兼容的图像导出，让AI能够直接查看和分析GIMP图像。

主要功能点

  • AI驱动的图像编辑： 通过对话式命令，使用AI助手轻松编辑GIMP中的图像。
  • MCP兼容的图像导出： 将当前GIMP图像导出为PNG格式，并以Base64编码的MCP 'Image'对象形式提供给AI，支持区域截取和缩放。
  • GIMP元数据快速访问： 无需导出图像数据即可获取图像的尺寸、图层、通道等详细元数据，以便AI进行智能决策。
  • 全面GIMP环境信息： 获取GIMP的版本、安装路径、能力等详细环境信息，辅助AI进行故障诊断和优化操作。
  • PyGObject API访问： 允许AI通过调用GIMP的Python API执行几乎所有GIMP操作，实现高度定制化的图像处理。
  • 会话保持： 命令执行在持久化会话中，确保GIMP状态在不同操作间保持。
  • 多格式导出支持： 可通过API导出PNG、JPEG、BMP、TIFF等多种格式，并控制质量。

安装步骤

  1. 前提条件：

    • GIMP 3.0 或更高版本
    • Python 3.8+
    • 'uv' (现代Python包安装和解析器)
    • MCP兼容的AI客户端（例如Claude Desktop, Gemini CLI, PydanticAI）

  2. 克隆仓库并安装Python依赖：

    git clone https://github.com/maorcc/gimp-mcp.git
cd gimp-mcp
uv sync

  3. 安装GIMP插件： 将 'gimp-mcp-plugin.py' 文件复制到GIMP的插件目录，并确保其具有可执行权限。

    • Linux/macOS快速安装：
      • 标准GIMP安装: 
        mkdir -p ~/.config/GIMP/3.0/plug-ins/gimp-mcp-plugin
cp gimp-mcp-plugin.py ~/.config/GIMP/3.0/plug-ins/gimp-mcp-plugin/
chmod +x ~/.config/GIMP/3.0/plug-ins/gimp-mcp-plugin/gimp-mcp-plugin.py
      • Snap安装GIMP: 
        mkdir -p ~/snap/gimp/current/.config/GIMP/3.0/plug-ins/gimp-mcp-plugin
cp gimp-mcp-plugin.py ~/snap/gimp/current/.config/GIMP/3.0/plug-ins/gimp-mcp-plugin/
chmod +x ~/snap/gimp/current/.config/GIMP/3.0/plug-ins/gimp-mcp-plugin/gimp-mcp-plugin.py
    • 手动安装： 参考 GIMP Plugin Installation Guide (Wikibooks) 查找您的GIMP插件文件夹。

  4. 重启GIMP 以加载新安装的插件。

MCP服务器配置（给MCP客户端使用的配置信息）

MCP客户端需要知道如何启动GIMP MCP服务器才能与其通信。以下是针对不同MCP客户端的配置示例，其中服务器名称统一为 'gimp'，启动命令为 'uv run'，并指定了服务器脚本的路径。请注意，'/full/path/to/gimp-mcp' 需要替换为 'gimp-mcp' 仓库在您系统上的绝对路径。

  • Claude Desktop 配置示例： 在 '~/.config/Claude/claude_desktop_config.json' (Linux/macOS) 或 '%APPDATA%\Claude\claude_desktop_config.json' (Windows) 中添加或修改以下JSON片段：

    {
  "mcpServers": {
    "gimp": {
      "command": "uv",
      "args": [
        "run",
        "--directory",
        "/full/path/to/gimp-mcp", // 替换为gimp-mcp仓库的实际路径，例如 "/home/user/gimp-mcp"
        "gimp_mcp_server.py"
      ]
    }
  }
}
    • 'gimp': 服务器的名称，AI助手将使用此名称来调用GIMP功能。
    • 'command': 启动MCP服务器所使用的命令，这里是'uv'。
    • 'args': 传递给'command'的参数列表，包括'run'指令、'--directory'指定GIMP MCP仓库路径以及服务器主脚本'gimp_mcp_server.py'。

  • Gemini CLI 配置示例： 在 '~/.config/gemini/.gemini_config.json' 中添加或修改以下JSON片段：

    {
  "mcpServers": {
    "gimp": {
      "command": "uv",
      "args": [
        "run",
        "--directory",
        "/full/path/to/gimp-mcp", // 替换为gimp-mcp仓库的实际路径，例如 "/home/user/gimp-mcp"
        "gimp_mcp_server.py"
      ]
    }
  }
}
    • 配置项与Claude Desktop类似，'gimp' 为服务器名称，'command' 为 'uv'，'args' 为启动参数。

  • PydanticAI (Python 客户端) 配置示例： 在您的Python代码中，可以使用 'MCPServerStdio' 类来配置：

    from pydantic_ai import Agent
from pydantic_ai.mcp import MCPServerStdio

server = MCPServerStdio(
    'uv', # 启动命令
    args=[
        'run',
        '--directory',
        '/full/path/to/gimp-mcp', # 替换为gimp-mcp仓库的实际路径，例如 "/home/user/gimp-mcp"
        'gimp_mcp_server.py' # MCP服务器主脚本
    ]
)
agent = Agent('openai:gpt-4o', mcp_servers=[server])
    • 'MCPServerStdio' 接受启动MCP服务器的命令及其参数。

  • 其他MCP客户端： 对于支持stdio传输协议的其他MCP客户端，可以使用以下命令来启动GIMP MCP服务器：

    uv run --directory /full/path/to/gimp-mcp gimp_mcp_server.py

    客户端通常会在内部执行此命令，并通过标准输入/输出与服务器通信。

基本使用方法

  1. 启动GIMP： 打开GIMP，并打开一张图片。
  2. 启动MCP服务器： 在GIMP菜单中，导航到 '工具 > Start MCP Server'。服务器将监听 'localhost:9877'。
  3. 启动您的MCP客户端： 启动已配置好GIMP MCP服务器的AI客户端（例如Claude Desktop）。
  4. 开始创作： 您可以通过自然语言指令与AI助手交互，让它使用GIMP执行图像编辑操作。
    • 例如，您可以说：“在GIMP中绘制一张脸和一只羊。”
    • 要查看当前图像：“你能给我看看GIMP中当前的图像，并告诉我你看到了什么？”
    • 获取图像信息：“当前图像的尺寸和属性是什么？”
    • 执行复杂工作流：“创建一个800x600的新图像，在中心绘制一个蓝色圆圈，添加红色边框，然后向我展示结果。”

信息

分类

AI与计算

访问项目