GIMP

gimp-mcp

AI アシスタントにやりたいことを伝えると、GIMP で実現する様子を見られます。 gimp-mcp は、Claude、Codex、Cursor、VS Code など、あらゆる MCP クライアントを、すでに開いている GIMP のウィンドウに接続します。ファイルを開き、レイヤーを作成し、編集可能なテキストを設定し、選択範囲を作成し、フィルターを適用してエクスポートするまでの手順を、目の前で実行します。

_{実際の未編集セッションを2倍速で再生：Claude Codeでプロンプトを1つ入力するだけで、あとはすべてgimp-mcpを通じてGIMPが実行します。高画質動画（1080p、実時間）。}

クイックスタート

gimp-mcp は Linux、macOS、Windows で動作します。GIMP 3.2 以降、uv、および MCP クライアントが必要です。Ubuntu 26.04 の場合：

sudo apt install -y gimp python3-gi gir1.2-gimp-3.0   # GIMP 3.2+ (other distributions and Flatpak: see below)
uvx gimp-mcp setup                                    # installs the GIMP plug-in, adds the server to your MCP clients
uvx gimp-mcp doctor                                   # after (re)starting GIMP: every check should be [ok]

続いて、アシスタントに 「GIMPを使って1280×720の画像を作成し、タイトルに『Hello』を入れて、~/hello.png にエクスポートして」 と依頼します。

• macOS および Windows： gimp.org から GIMP 3.2 をインストールし、同じ uvx gimp-mcp setup と uvx gimp-mcp doctor を実行してください（インストール手順）。
• Arch、Debian 14、Fedora 44、openSUSE Tumbleweed、Alpine 3.24、および Flathub 版の GIMP については、互換性をご覧ください。
• Claude Code、Claude Desktop、VS Code と Cursor、およびその他の MCP クライアント（Codex、Zed など）の手順を、ステップごとに説明しています。
• 問題が発生しましたか？ uvx gimp-mcp doctor を実行すると、問題の内容と解決方法が表示されます（トラブルシューティング）。

gimp-mcp を選ぶ理由

使っている GIMP で作業します。 アシスタントは隠れたコピーではなく、開いている GIMP で作業します。追加したレイヤーはすべてレイヤーパネルに表示され、いつでもマウスで作業を引き継げます。

あとから編集できる結果です。 タイトルは編集可能なテキストレイヤーのまま保持され、各工程を別々のレイヤーに配置でき、ぼかしや色補正は編集可能なフィルターにでき、XCF にすべて保存されます。アシスタントが作るのは出発点であり、統合された PNG ではありません。

自分の作業を確認します。 プレビュー画像がモデルに返されるため、結果を確認し、気になる箇所を修正してから書き出せます。チェックポイントを使えば、アイデアを試し、うまくいかなかったときに以前の状態へ戻れます。

ローカルで安全です。 ネットワークポートは使いません。自分だけが開ける Unix ソケット、GIMP の起動ごとに新しく発行されるトークン、固定された操作セット、呼び出し可能な GIMP 手続きの許可リストを使用します（eval や Script-Fu のパススルーはありません）。詳細はセキュリティモデルをご覧ください。

1 つのコマンドでセットアップできます。 gimp-mcp setup が GIMP（ディストリビューションパッケージまたは Flatpak）を検出し、プラグインをインストールして、Claude Code、Claude Desktop、VS Code、Cursor にサーバーを追加します。ファイルを変更する前に確認を求めます。

依頼例

• 「~/Pictures/team.jpg を開いて、中央を基準に正方形に切り抜き、512 px のアバターを書き出してください。」
• 「ブログ記事『Shipping on Fridays』用に、暗い背景で左側にタイトルを配置した 1200×630 のソーシャルカードを作ってください。」
• 「poster.xcf の背景レイヤーだけを明るくし、元のレイヤーはその下に非表示で残してください。」
• 「~/design/flyer.xcf には何がありますか？ レイヤー、非表示のレイヤー、使用フォントを一覧表示してください。」
• 「car.jpg のナンバープレートをぼかして、隣にコピーを保存してください。」

ユースケース

MCP を通じて最初から最後まで処理する、GIMP の一般的な作業例です。各作業には Linux、macOS、Windows の CI で検証されるスクリプト版と、評価スイートに含まれるエージェント版（自然言語による依頼 1 件）があります。

• 古いスキャン写真の修復：傾きの補正、スキャナー台の切り抜き、ほこりや傷の修復、コントラストの復元、粒状感の軽減、印刷用の 16-bit TIFF （手順）。
• オンラインストア用の商品写真：ピクセルを損なわずに切り抜き、純白の背景に柔らかな影を追加し、中央揃えの正方形にして、sRGB プロファイル付きの JPEG と WebP を 3 サイズで作成 （手順）。
• ソーシャルメディア用素材一式：1 つのデザインを 4 形式（投稿、ストーリー、バナー、サムネイル）で作成し、安全領域ガイドと編集可能な見出しを追加 （手順）。
• チュートリアル用スクリーンショット：注釈と矢印を追加し、個人情報を復元不能なほどピクセル化して、メタデータを削除 （手順）。
• ウェブサイト用写真：フォルダー内の写真の向きを整え、サイズ変更、透かしの追加、GPS 情報の削除を行い、WebP と JPEG を作成。不正なファイルは報告 （手順）。
• アニメーションステッカー：タイミングと破棄方法を設定したフレームを作成し、ファイルサイズの上限内に収まるよう GIF とアニメーション WebP を最適化 （手順）。
• 印刷用フライヤー：塗り足し、トンボ、安全マージンのガイドを付けた 300 dpi の A5 サイズを作成し、印刷サイズの PDF と TIFF を出力 （手順）。
• YouTube サムネイル：写真 1 枚から編集可能なタイトル付きで作成 （ガイド）。

できること

表示	開いている画像の一覧表示、レイヤーツリーと項目の確認、モデルが参照できるプレビューの表示
ファイル	XCF の作成、開く、保存、オプション付きの PNG および JPEG へのエクスポート、閉じる
レイヤー	追加、インポート、複製、グループ化、順序変更、名前変更、不透明度、合成モード、表示状態
形状	画像またはキャンバスのサイズ変更、切り抜き、拡大縮小、回転、反転、移動
選択	矩形と楕円（追加、減算、交差、ぼかし）、反転、レイヤーマスク
描画	塗りつぶし、線とパス、矩形と楕円
テキスト	編集可能なテキストレイヤー：フォント、サイズ、色、配置、間隔
調整	明るさ／コントラスト、色相／彩度、ぼかしを、破壊的または編集可能なフィルターとして適用
履歴	アンドゥグループ（GIMP で Ctrl+Z を 1 回押す操作）と、アシスタントが復元できるチェックポイント
その他すべて	GIMP の残り約 420 の手順を許可リストに登録（オプトインの procedures ツールセット）

全 54 ツールをツールセットにまとめているため、クライアントは必要なものだけを読み込めます。ツールリファレンスと 対応範囲の一覧をご覧ください。

仕組み

 Claude / Codex / Cursor / …            gimp-mcp serve                 GIMP 3.2
 ───────────────────────────  MCP   ─────────────────────  Unix   ─────────────────────────
  "make the colors pop"      stdio   validates, maps ids  socket   gimp-mcp-bridge plug-in
                            ──────▶  to GIMP operations  ──────▶   runs them in your session

gimp-mcp setup は小さな Python プラグインを GIMP のプロファイルにコピーします。GIMP の起動時にプラグインも起動し、GIMP の実行中はローカルソケットを提供します。MCP サーバー（クライアントが起動する uvx gimp-mcp serve）がプラグインと通信します。 スクリプトや CI 用に、ヘッドレスの GIMP でも動作します。詳しくはアーキテクチャの解説をご覧ください。

ドキュメント

• インストールリファレンス（手動インストール、アップグレード、アンインストール） · MCP クライアント · トラブルシューティング · 互換性
• ツールリファレンス · 対応範囲の一覧 · スクリプトを使ったデモの手順
• アーキテクチャ · ブリッジプロトコル · セキュリティ · 設計上の決定事項
• テスト · リリース · デモ動画の録画 · GIMP の動作に関する注意点 · 変更履歴

公式 MCP レジストリにも io.github.mhbxyz/gimp-mcp として掲載されています。MIT ライセンスです。