RenPy MCP — AI-Powered Dev Tools for Ren'Py

Connect your AI assistant (Claude Code, Claude Desktop, etc.) directly to your Ren'Py project. 55 tools that automate the tedious parts of visual novel development.

What does it do?

Type a natural language request, and the AI calls the right tools:

• “Show me the story flow graph” → generates a visual map of all labels, choices, and endings
• “Screenshot the scene where Sylvie appears at the library” → searches your script, warps to that line, and captures a real game screenshot
• “How complete are the Japanese translations?” → shows completion % and lists missing strings
• “Rename character 's' to 'sylvie' — dry run first” → previews all 235 changes across every file before applying

55 Tools in 9 Categories

Category	Tools	What it does
Project	7	Lint, compile, build, inspect config
Preview	3	Screenshot any scene, generate galleries
Testing	3	Run test cases, create tests, reports
Analysis	13	Story graphs, dead ends, character maps, variable tracking, consistency checks
Assets	4	List images/audio, find unused assets, verify dimensions
Refactoring	4	Rename characters/labels, extract routes, insert dialogue
Translation	7	Completion stats, find untranslated, auto-translate
Live Debug	12	Eval expressions, inspect styles, jump labels, set variables in running game
Docs	2	Search 89 official Ren'Py documentation topics

Before / After

Without RenPy MCP	With RenPy MCP
Launch game to check each scene	screenshot_scene captures any scene instantly
Click through routes to test paths	run_test executes automated test cases
Search .rpy files with grep	search_script with regex across all scripts
Count translations by hand	list_translations shows completion % per language
Rename character across 50 files	rename_character handles everything in one call
Can't inspect running game state	live_get_state shows every variable in real time

Requirements

• Ren'Py SDK 8.x — download
• Python 3.11+
• MCP-compatible AI client: Claude Code, Claude Desktop, or any MCP client

Quick Start

1. Download and extract the zip
2. Open a terminal in the extracted folder:

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

3. Add to your .mcp.json:

   {
     "mcpServers": {
       "renpy-mcp": {
         "command": "uv",
         "args": ["run", "--directory", "/path/to/renpy-mcp", "renpy-mcp"],
         "env": { "RENPY_SDK_PATH": "/path/to/renpy-sdk" }
       }
     }
   }

See INSTALL.md in the zip for detailed setup (Claude Desktop, pip, troubleshooting).

Then just ask:

“Set my project to the_question”
“Show me the character map”
“Take a screenshot of chapter 2”

Links

• Website
• Discord
• Demo Video (YouTube)