Gimp MCP

🚀 GIMP MCP

このプロジェクトは、非技術者でも簡単な会話形式のコマンドでGIMPを使って画像を編集できるようにします。GIMPの強力な機能と自然言語対話の間のギャップを埋め、専門家にとっても従来のクリック操作よりも高速に複雑な多段階の作業フローを実行できます。

ユーザーは、基本的な写真調整から高度な芸術的な修正まで、自分が達成したいことを説明することができます。例えば、「背景を明るくしてヴィンテージフィルターを追加」や「赤目を取り除いて被写体を鮮明にする」などの要求をシステムが正確なGIMP操作に変換します。

このプロジェクトは機能的であり、MCPを介してすべてのGIMP機能を公開しています。主な開発焦点は、AIエージェントがGIMPを効率的に使用できるように包括的なAI読み取り可能なドキュメントを作成することです。

🚀 クイックスタート

このセクションでは、GIMP MCPを使用するための基本的な手順を説明します。以下の手順に従って、GIMP MCPをセットアップし、画像編集を始めましょう。

✨ 主な機能

• 非技術者でも自然言語コマンドでGIMPを操作できる。
• 専門家にとっても複雑な作業フローを高速に実行できる。
• 基本的な写真調整から高度な芸術的な修正まで、様々な要求に対応。

📦 インストール

前提条件

• GIMP 3.0以上: このプロジェクトはGIMP 3.0で開発およびテストされています。
• MCP互換のAIクライアント: Claude Desktop、Gemini CLI、PydanticAI、またはその他のMCPクライアント。
• uv: 最新のPythonパッケージインストーラーとリゾルバー。

1. mcpサーバー用のGIMPプラグインをインストールする

プラグインをインストールするには、gimp-mcp-plugin.pyをGIMPのplug-insディレクトリにコピーします。

異なるオペレーティングシステムでGIMPプラグインフォルダを見つけるための詳細な手順については、以下のガイドを参照してください。

GIMP Plugin Installation Guide (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で任意の画像を開き、Tools > Start MCP Serverの下に新しいメニュー項目が表示されるはずです。これをクリックして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

Gemini CLIのMCPサーバーを~/.config/gemini/.gemini_config.jsonで設定します。

{
  "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で任意の画像を開き、Toolsメニューの下でStart MCP Serverをクリックします。
2. MCPクライアント（Claude Desktop、Gemini CLIなど）を起動します。
3. 「Gimpで顔と羊を描いて」のように、AIにGIMPと対話するように指示します。

実行例

「GIMP MCPを使って「顔と羊を描いて」というプロンプトからの出力例

📚 ドキュメント

改善提案

• レシピの追加: 一般的なGIMPタスクと作業フローをMCPレシピとしてまとめる。
• アンドゥ機能: MCPインターフェイスを介してGIMPでアクションを取り消せるようにする。
• 視覚的なフィードバック: GIMPで実行されたアクションに対して、修正された画像やレイヤーを表示するなど、MCPクライアントに視覚的なフィードバックを提供する。
• APIの探索: 利用可能なGIMP関数を個別のMCPツールとして公開する動的なツール探索を作成し、手動のPyGObjectコードを必要としないようにする。
• エラーコンテキスト: エラーメッセージに特定のGIMP APIコンテキスト、行番号、および一般的な問題の修正提案を追加する。
• GIMPプラグインの堅牢性: リソースが適切に解放されるようにし、PyGObject APIに対するmcpクライアントの誤動作を防ぐ。

🤝 コントリビューション

貢献は大歓迎です！バグ修正、新機能の追加、またはドキュメントの改善など、何でも構いません。自由にプルリクエストを送信するか、イシューを開いてください。

📄 ライセンス

このプロジェクトはGPL v3ライセンスの下で公開されています。詳細については、こちらを参照してください。