FrameRonin MCP

Overview

FrameRonin MCP wraps the FrameRonin pixel art toolset into an MCP (Model Context Protocol) server. AI assistants can directly generate sprites via multiple backends, remove backgrounds, compose sprite sheets, convert GIFs, pixelate images, and extract video frames — all through tool calls.

Original project: systemchester/FrameRonin — a full-stack web application with UI for pixel art processing. This MCP server extracts the core algorithms and adds AI-powered generation, making them callable by Claude, Gemini CLI, Copilot, and other MCP-compatible AI tools.

What Can AI Do With This?

"Generate a pixel art fire mage sprite sheet and prepare it for RPG Maker"
  → generate_rpgmaker("fire mage, red robes", rows=4, cols=4, width=48, height=48)
  → 16 frame PNGs, transparent background, no watermark, ready to import

"Remove the green screen from this actor photo"
  → image_chroma_key("actor_green_screen.png", key_color="green", tolerance=40)

"Convert this video of a walk cycle into a sprite sheet"
  → video_to_spritesheet("walk_cycle.mp4", fps=12, columns=4)

"Turn this high-res artwork back into pixel art"
  → image_pixelate("artwork.png", num_colors=16, scale_result=4)

Prompt Auto-Expansion

All generate_* tools automatically expand short prompts to 2000+ characters with professional pixel art specifications — color palette rules, anti-aliasing bans, dithering patterns, sprite sheet layout conventions, and RPG Maker format requirements. Just describe your character/item/monster in plain language; the framework handles the technical details.

Demo — Full Pipeline

Input: "a warrior with silver armor and a sword" — automatically expanded, then processed through all 5 steps:

All 16 frames extracted at native resolution — 4 directions × 4 animation frames:

Final output: 16 PNGs (48×48, transparent background) — directly importable into RPG Maker MV, Godot, Unity, or any 2D game engine.

Install

pip install frame-ronin-mcp

Requires Python 3.11+, FFmpeg (for video tools), Chrome (for Gemini web generation).

Configure

Add to your MCP client config (e.g. .claude/mcp.json for Claude Code):

{
  "mcpServers": {
    "frame-ronin": {
      "command": "frame-ronin-mcp"
    }
  }
}

No environment variables needed for free Gemini generation or any post-processing tools.

Tools (22)

Generation — 6 tools

Five independent backends + one unified pipeline. Each backend is a self-contained module — add new ones by dropping a .py file.

generate_rpgmaker pipeline: generate → remove Gemini watermark → AI background removal (rembg/U2Net) → resize to RPG Maker grid → split into individual frame PNGs. All in one call.

Processing — 16 tools

Project Structure

FrameRonin-MCP/
├── frame_ronin_mcp/
│   ├── server.py               # MCP server entry point
│   ├── tools/
│   │   ├── generate/           # Multi-backend image generation
│   │   │   ├── gemini_web.py   #   Gemini free web app (Playwright)
│   │   │   ├── gemini_api.py   #   Gemini API (google-genai)
│   │   │   ├── dalle.py        #   OpenAI DALL-E 3
│   │   │   ├── stability.py    #   Stability AI
│   │   │   └── siliconflow.py  #   SiliconFlow (Qwen/FLUX)
│   │   ├── video.py            # FFmpeg + rembg pipeline
│   │   ├── matting.py          # AI/chroma/double-bg matting
│   │   ├── image.py            # Resize, crop, watermark removal
│   │   ├── gif_sprite.py       # GIF extraction, sprite sheet ops
│   │   └── pixelate.py         # Proper pixel art conversion
│   └── lib/                    # Core algorithms (pure Python)
│       ├── watermark.py        # Gemini watermark removal
│       ├── chroma_key.py       # Chroma key matting
│       ├── double_bg.py        # Double background matting
│       ├── mesh.py             # OpenCV grid detection
│       └── pixelate_core.py    # Proper pixel art algorithm
├── pyproject.toml
└── README.md

Related

• FrameRonin — original web application with full UI
• proper-pixel-art — pixel art downsampling algorithm
• GeminiWatermarkTool — watermark removal technique

License

MIT © FrameRonin