RenPy MCP - AI-Powered Development for Ren'Py Visual Novels

The Problem

Ren'Py development is manual.

Every check requires launching the game, clicking through scenes, and reading files by hand. RenPy MCP automates the entire loop.

Without RenPy MCP

Launch game to visually check each scene
Click through routes to test story paths
Search .rpy files with grep
Count translation progress manually
Rename characters with find-and-replace across files
No way to inspect a running game's state

With RenPy MCP

screenshot_scene captures any scene instantly
run_test executes automated test cases
search_script with regex across all scripts
list_translations shows completion % per language
rename_character handles all files in one call
live_get_state shows every variable in real time

Features

Everything you need, in one server.

55 tools covering every aspect of Ren'Py development, from first script to final build.

🛠

Project Management

Lint, compile, build distributions, inspect package configuration. 7 tools to manage your project lifecycle.

🎨

Visual Preview

Screenshot any scene by warping to it. Generate visual galleries of your entire game automatically.

✅

Automated Testing

Run test cases, create new tests, generate pass/fail reports across all story routes.

📊

Story Analysis

13 tools: character maps, variable tracking, dead-end detection, dialogue consistency, accessibility checks, and more.

🎴

Asset Management

List all images and audio, find unused assets, verify dimensions match your game resolution.

🔧

Refactoring

Rename characters and labels across all files with dry-run preview. Extract routes, insert dialogue precisely.

🌐

Translation

View completion per language, find missing strings, generate templates, prepare entries for AI translation.

⚡

Live Integration

12 tools for real-time debugging: eval expressions, inspect styles, jump to labels, set variables, take screenshots of the running game.

📖

Documentation

Search 89 official Ren'Py doc topics directly from your AI assistant. No browser needed.

Setup

Three steps to get started.

Works with Claude Desktop, Claude Code, and any MCP-compatible client.

Install

Download from itch.io, extract, and install with uv or pip.

cd renpy-mcp
uv venv && uv pip install -e .

Configure

Add the server to your MCP client config with your SDK path.

{
  "mcpServers": {
    "renpy-mcp": {
      "command": "uv",
      "args": ["run", "renpy-mcp"],
      "env": { "RENPY_SDK_PATH": "..." }
    }
  }
}

Use

Ask your AI assistant to work with your Ren'Py project in natural language.

"Set my project to /path/to/game"
"Show me the character map"
"Take a screenshot of chapter 2"
"How complete are translations?"

Architecture

Two integration modes.

CLI batch for offline analysis, file-based IPC for live game debugging.

AI Client          MCP Protocol          RenPy MCP Server
(Claude)    <--- JSON-RPC over stdio --->    (Python)
                                                 |
                                          +------+------+
                                          |             |
                                   CLI Batch     File IPC
                                   renpy.exe     bridge_script.rpy
                                   (lint,        (cmd.json →
                                    test,         status.json)
                                    warp,
                                    compile)

AI-Powered Dev Tools
for Ren'Py