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許可證。