RenPy MCP

MCP server + visual development tools for Ren'Py visual novel engine. 60 tools, story map, live dashboard, standalone CLI.

GitHub

RenPy MCP + DevTools

MCP server and visual development tools for Ren'Py visual novel engine.

60 tools in 10 categories — preview scenes, analyze story flow, manage translations, refactor characters, and control the running game through natural language or your browser.

Screenshots

Story Map

Interactive graph of all labels, jumps, and menus. Click a node to warp the running game there.

Story Map

Dev Dashboard

Live preview, variable inspector with tree view, quick actions — all while the game runs.

Dashboard

Warp-on-Click Demo

https://github.com/user-attachments/assets/og6ZKTafSGk

Warp-on-Click Demo

Features

AI-Powered (MCP)

Connect Claude (or any MCP client) directly to your Ren'Py project:

  • Project Management — lint, compile, build, inspect config
  • Visual Preview — screenshot any scene by warping to it
  • Automated Testing — run test cases, generate reports
  • Story Analysis — flow graphs, dead ends, character maps, variable tracking
  • Asset Management — list images/audio, find unused assets
  • Refactoring — rename characters/labels, extract routes
  • Translation — completion stats, find untranslated, auto-translate
  • Live Debugging — eval, inspect, jump labels, set variables in a running game
  • Documentation — search 89 official Ren'Py doc topics

Visual DevTools (no AI needed)

A standalone browser-based development dashboard:

  • Story Map — interactive graph of all labels, jumps, and menus. Click a node to warp the running game there.
  • Dev Dashboard — live preview, variable inspector with tree view for dicts/lists, quick actions
  • Script Editor — browse and edit .rpy files with syntax highlighting
  • Playtest Heatmap — visualize which parts of your game are most played
  • Asset Manager — browse images and audio, find unused assets
renpy-webui --project /path/to/my-game

Installation

Prerequisites

Setup

  1. Download from itch.io and extract to a permanent location
  2. Install dependencies: 
    cd renpy-mcp
uv venv && uv pip install -e .
  3. Configure your AI client (.mcp.json in your project directory): 
    {
  "mcpServers": {
    "renpy-mcp": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/renpy-mcp", "renpy-mcp"],
      "env": {
        "RENPY_SDK_PATH": "/path/to/renpy-8.x-sdk"
      }
    }
  }
}

Standalone DevTools (no AI client required)

cd renpy-mcp
uv run renpy-webui --project /path/to/my-game

See the full Installation Guide for details.

Demo

Full Demo Video

Links

License

Commercial software. See itch.io for purchasing.

Server Terkait