Scumble MCP
The Scumble desktop editor with an MCP server of 119 tools: an agent opens, selects, generates and exports images.
- 176 ★ on the repository
- Last commit
- GPL-3.0
Extended access
Why this level
- The agent opens and exports image files on your disk.
- The `generate` command spends model API keys or your ComfyUI time.
Install
- Works in
Manual install
winget install scumbleWindows app install; then Help, Copy MCP registration in the editor itself.
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- The agent opens and exports image files on your disk.
- The `generate` command spends model API keys or your ComfyUI time.
This is third-party code. Review the repository files before installing.
What it does
Scumble is a free AI image editor for Windows (GPL-3.0). You select an area or draw boxes on an empty canvas, describe what should be there, and the result lands as a new layer colour-matched to its surroundings. Generation runs through your own ComfyUI (local or remote), Comfy Cloud or API keys for FLUX, GPT Image, Nano Banana, Seedream and other models. Every editor function is a command and the commands serve as an MCP server: `Scumble --mcp` starts the server over stdio. When the editor is already open, the server drives that instance, otherwise it starts the app without a window and closes it when the client disconnects. The agent (Claude Code, Claude Desktop, Cursor) gets 119 tools: open an image, select, generate, add layers and filters, look at a screenshot, export, all in the same documents with the same undo history. The `--run` mode executes command batches from a steps file and `--cmd` calls a single command.
Who it is for. Designers and developers on Windows who want an agent to work with images and layers in an editor with AI generation.
Good fit when
- The agent replaces the background in a selected area from a description and adds the result as a layer.
- Batch processing of an image folder from a steps file with `--run`.
- The agent looks at a canvas screenshot, judges the result and asks for a rework.
- Exporting the finished image after layers are assembled and flattened.
Not a fit when
- macOS is needed: there is no version for it yet and Linux builds are early.
- There is no ComfyUI and no model keys: `generate` creates nothing without a fitting backend.
- Only simple edits without AI are needed: an ordinary editor is enough.
Example request
Open a photo in Scumble, select the sky, replace it with a sunset and export the result as PNG, showing a screenshot first.MCP
- Transport
- stdio
- Authentication
- not required
Limitations
The project is young (version 0.1.x), rough edges are possible and image copies are best kept elsewhere. Windows 10 and 11 is the main platform; Linux has an AppImage and deb built in CI and not yet run by the author, macOS has not started. Installation is from the Microsoft Store, `winget install scumble`, an installer or a portable archive. The MCP server itself does not require ComfyUI, but `generate` needs the backend of the chosen recipe. Keys are encrypted for the Windows account and must be typed again on another computer.
How to disable. Remove the Scumble entry from the MCP client config or the `.mcpb` extension in Claude Desktop settings. The app itself is removed like a regular Windows program.
FAQ
How do I connect Scumble to Claude Code?
Through Help, Copy MCP registration in the editor itself, which copies a ready registration command for the `Scumble --mcp` server.
Is ComfyUI required?
Not for the server itself. The `generate` tool uses the backend of the chosen recipe: your ComfyUI, Comfy Cloud or API keys.
What happens if the editor is closed?
`Scumble --mcp` starts the app without a window and closes it when the client disconnects. The `--attach-only` flag forbids starting and attaches only to a running instance.
How do I run a batch of operations?
With `Scumble --run steps.json`: steps run in order on one instance, one JSON line per step.
Where are API keys stored?
Inside the app, encrypted for your Windows account, and they have to be typed again on another computer.
Discussion
No questions or reviews yet.
Related
MCP serversAn MCP server that edits images through Photopea: layers, text, effects and export, 46 tools for Claude Code and Cursor.
An MCP server giving an agent 123 Aseprite tools for pixel art and animation, plus previews to check its own drawing
A video editor with a local MCP server: an agent reviews the cut, edits the timeline and starts exports, ComfyUI generates
The MCP server gives agents GIMP image editing with visual previews, layers, filters and file export operations.
A local MCP server for editing and analyzing images: the agent crops frames, finds objects and reads text from photos
Open source design editor with a built-in MCP server: Claude and Cursor create and edit designs on your own server
README in short
The README presents Scumble as an AI image editor: a layer for every result, colour matching, work with ComfyUI and API keys, an assistant inside the app, Windows installation and the MCP mode. The docs/MCP.md page covers starting the server, batch mode and headless operation.