chenweichiang

Gimp MCP — AI skill for Claude Code

AI community

Fork of maorcc/gimp-mcp: an MCP server that lets AI agents drive GIMP 3.x with live visual feedback (56 tools, mid-workflow PNG snapshots).

How to install Gimp MCP

This entry records only its repository, not the path inside it, so there is no exact command to give. Open chenweichiang/gimp-mcp and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Gimp MCP does

Fork of maorcc/gimp-mcp: an MCP server that lets AI agents drive GIMP 3.x with live visual feedback (56 tools, mid-workflow PNG snapshots). Kept identical to upstream; my local changes (alpha export fix, headless remote mode, mesh tunnel) are maintained as separate patch files rather than committed here.

Alternatives in AI

  • Sentrux — Real-time architectural sensor that helps AI agents close the feedback loop, enabling recursive self-improveme 2.9k ★
  • Upstream Watch — Review pydantic-ai and pydantic-ai-harness releases published since the last watch entry, and record a verdict 361 ★
  • Mirofish CLI — Multi-agent AI prediction engine - digital sandbox for scenario simulation (fork of 666ghj/MiroFish) 307 ★

README

GIMP MCP

[![License: GPL v3](https://img.shields.io/badge/License-GPLv3-blue.svg)](https://www.gnu.org/licenses/gpl-3.0) [![Works with Claude Desktop](https://img.shields.io/badge/Works%20with-Claude%20Desktop-7B2CBF.svg)](https://claude.ai/desktop) [![GIMP 3.2](https://img.shields.io/badge/GIMP-3.2-orange.svg)](https://gimp.org) [![MCP Compatible](https://img.shields.io/badge/MCP-Compatible-green.svg)](https://modelcontextprotocol.io) [![CodeRabbit](https://img.shields.io/badge/CodeRabbit-AI%20Review-171717?logo=coderabbit)](https://coderabbit.ai)

Demo

![GIMP MCP in action — AI agent driving GIMP through natural language](docs/mcpInAction.gif)

Full demo (with audio): https://github.com/maorcc/gimp-mcp/raw/main/docs/demo.mp4

*AI agent using GIMP MCP to remove a background, edit a character's expression, and verify results — all through natural language via Claude*


Overview

GIMP MCP bridges GIMP's professional image editing capabilities with AI assistants through the [Model Context Protocol](https://modelcontextprotocol.io). It lets you edit images by describing what you want — and gives the AI a live visual feedback channel to verify each change before moving on.

**What makes it different from other GIMP integrations:**

  • The AI can see the image at any point in the workflow without saving to disk (get_state_snapshot)
  • Supports fully autonomous multi-step pipelines: open → edit → verify → refine → export
  • 56 dedicated tool commands covering every major GIMP operation
  • Fully compatible with GIMP 3.2.x (all breaking API changes resolved)

Key Features

👁️ Live Visual Feedback get_state_snapshot returns a PNG preview mid-workflow so the AI verifies each step
🎨 56 GIMP Tools Adjustments, transforms, selections, layers, drawing, text, filters — all via MCP
🔧 GIMP 3.2 Compatible All GIMP 3.2 API breaks fixed and tested (56/56 passing)
🔁 Iterative Workflows AI loops until a goal is