Gimp MCP

🚀 GIMP MCP

本项目让非专业技术用户通过简单的对话式指令就能使用GIMP进行图像编辑，弥合了GIMP强大功能与自然语言交互之间的差距。同时，它还能让专业人士以比传统点击操作更快的速度执行复杂的多步骤工作流程。

🚀 快速开始

在使用本项目前，请确保满足以下前提条件：

• GIMP 3.0及以上版本：本项目基于GIMP 3.0开发和测试。
• 兼容MCP的AI客户端：如Claude Desktop、Gemini CLI、PydanticAI或其他MCP客户端。
• uv：一个现代的Python包安装器和解析器。

✨ 主要特性

用户可以描述自己想要实现的操作，从基本的照片调整到复杂的艺术修饰都能实现。例如，“提亮背景并添加复古滤镜” 或 “去除红眼并锐化主体”，系统会将这些请求转化为精确的GIMP操作。该项目功能完备，可通过MCP调用GIMP的所有功能。目前的主要开发重点是创建全面的、可供AI读取的文档，以帮助AI代理高效使用GIMP。

📦 安装指南

1. 安装GIMP的mcp服务器插件

要安装该插件，请将 gimp-mcp-plugin.py 文件复制到你的GIMP plug-ins 目录。 关于在不同操作系统上查找GIMP插件文件夹的详细说明，请参考以下指南： GIMP插件安装指南 (Wikibooks) 确保插件文件具有 “执行” 权限。 例如，如果你的GIMP是通过snap安装的，可以使用以下命令将插件复制到正确的目录：

mkdir ~/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。在GIMP中打开任意图像，你应该会在 工具 > 启动MCP服务器 下看到一个新菜单项。点击它以启动MCP服务器。

2. 配置MCP客户端

根据你使用的MCP客户端进行相应配置：

Claude Desktop

在Claude Desktop配置文件中添加以下内容（在Linux/macOS系统中，配置文件路径为：~/.config/Claude/claude_desktop_config.json ）：

{
  "mcpServers": {
    "gimp": {
      "command": "uv",
      "args": [
        "run",
        "--directory",
        "your/path/to/gimp-mcp-server",
        "server.py" 
      ]
    }
  }
}

Gemini CLI

在 ~/.config/gemini/.gemini_config.json 中配置Gemini CLI的MCP服务器：

{
  "mcpServers": {
    "gimp": {
      "command": "uv",
      "args": [
        "run",
        "--directory",
        "your/path/to/gimp-mcp-server",
        "server.py"
      ]
    }
  }
}

PydanticAI

对于PydanticAI代理，请使用 MCPServerStdio 类：

from pydantic_ai import Agent
from pydantic_ai.mcp import MCPServerStdio

server = MCPServerStdio(
    'uv',
    args=[
        'run',
        '--directory',
        'your/path/to/gimp-mcp-server',
        'server.py'
    ]
)

agent = Agent('openai:gpt-4o', mcp_servers=[server])

其他MCP客户端

对于支持stdio传输的其他MCP客户端，请使用以下命令：

uv run --directory your/path/to/gimp-mcp-server server.py

💻 使用示例

⚠️ 重要提示

在开始使用前，请确保你的MCP客户端已配置好GIMP MCP服务器。

操作步骤如下：

1. 在GIMP中打开任意图像，在 “工具” 菜单下点击 启动MCP服务器。
2. 启动你的MCP客户端（如Claude Desktop、Gemini CLI等）。
3. 让AI与GIMP进行交互，例如 “使用GIMP绘制一张人脸和一只羊”。

示例输出

以 “使用GIMP绘制一张人脸和一只羊” 为提示的示例输出。

💡 使用建议

• 添加操作模板：创建一系列常见的GIMP任务和工作流程作为MCP操作模板。
• 撤销功能：通过MCP界面实现撤销GIMP操作的功能。
• 视觉反馈：为MCP客户端提供GIMP操作的视觉反馈，例如显示修改后的图像或图层。
• API发现：创建动态工具发现功能，将可用的GIMP函数作为独立的MCP工具暴露出来，而无需手动编写PyGObject代码。
• 错误上下文：在错误消息中增强特定的GIMP API上下文、行号，并针对常见问题提供建议的修复方法。
• GIMP插件健壮性：确保资源得到适当释放，并防止MCP客户端对PyGObject API的不当操作。

🤝 贡献代码

欢迎大家贡献代码！无论是修复bug、添加新功能还是改进文档，都可以随时提交拉取请求或提出问题。

📄 许可证

本项目采用GPL v3许可证。