Bitbound.ImageEditMcp 1.0.8

Image Edit MCP

A .NET Model Context Protocol (MCP) server that exposes SkiaSharp image editing tools over stdio.

Overview

This MCP server allows an agent (e.g. GitHub Copilot, OpenCode, etc.) to load an image from a file path, apply a wide range of SkiaSharp-powered edits on a working copy stored in a local data folder, read back the current state at any time, and save the result to a new file. create_image skips the file and starts from a blank canvas instead.

Requirements

• .NET 10 SDK
• Linux/macOS/Windows (SkiaSharp native assets are included per-platform)

Usage with GitHub Copilot

Add the following to your GitHub Copilot config (mcp.json):

{
  "mcpServers": {
    "image-edit-mcp": {
      "type": "stdio",
      "command": "dnx",
      "args": [
        "-y",
        "Bitbound.ImageEditMcp"
      ]
    }
  }
}

Building

dotnet build -c Release

The output binary is at bin/Release/net10.0/ImageEditMcp.dll.

How It Works

1. load_image loads an image from a file path and creates a working copy in the data folder (<config-dir>/image-edit-mcp/). create_image does the same thing from scratch, allocating a blank canvas of the requested size instead of decoding a file.
2. All subsequent edit tools operate on this working copy in memory.
3. read_image returns the current state as a base64-encoded PNG data URI.
4. save_image saves the working copy to a new file path (the original loaded file is never modified).
5. save_snapshot / load_snapshot allow you to checkpoint and restore intermediate states.

A working copy created by create_image has no source file, so reload_original is unavailable until load_image runs.

Available Tools

Core Operations

Transform Operations

Color Adjustments

Blur & Filter Operations

Drawing Tools

Utility

Architecture

ImageEditMcp/
├── Program.cs                          # MCP server entry point (stdio transport)
├── ImageEditor/
│   ├── ImageDataManager.cs             # Working copy lifecycle (load/save/snapshot)
│   └── ImageEditTools.cs               # All MCP tools (44 tools)
├── ImageEditMcp.csproj

The ImageDataManager is a singleton that manages:

• The in-memory working SKBitmap
• The source file path
• A working copy path in the data folder
• A dirty flag tracking unsaved changes

The ImageEditTools class contains all 44 MCP tools, each annotated with [McpServerTool] and parameter descriptions via [Description].

Data Directory

Working copies and snapshots are stored in:

• Linux: $HOME/.config/image-edit-mcp/
• macOS: ~/Library/Application Support/image-edit-mcp/
• Windows: %APPDATA%\image-edit-mcp\

License

MIT © Bitbound.