renforge — Claude Code MCP server for Ren'Py games
An MCP server, CLI and web dashboard for Ren'Py visual novels: inspect a project, launch the game, take screenshots, edit UI in the running build.
claude mcp add renforge -- uvx renforgeWhat renforge does
RenForge plugs into your agent as an MCP server and exposes tools for Ren'Py visual-novel work. The agent inspects project structure, scripts, labels and assets, launches the game with the Live Editor on by default, grabs screenshots, reads the scene tree and clicks on-screen controls. A web dashboard gives a human the same reach.
The Live Editor is the headline feature of 0.7. Pick an editable control on screen, look at its properties, move it, and write back to .rpy only when the target is safe for source. Locked targets stay inspectable and the reason is shown next to them. There is also a story map that warps the running game to a label, plus an asset audit for orphans and missing images.
You need Python 3.11+ and uv. Ren'Py itself does not have to be installed: RenForge picks up an SDK already on the machine or fetches one the first time you launch. On Debian and Ubuntu plain pip install is blocked by PEP 668, so use uvx or pipx. The project is alpha and APIs may still change.
What it helps with
- inspect a Ren'Py project and surface orphaned assets
- launch the game and capture the current scene
- move a UI control and save the change to source
- walk the story map and check label transitions
- generate translations and run a build
Example prompts for the agent
- Inspect my Ren'Py project at
/path/to/game - Launch the game and show me the scene tree
- Click the Start button and take a screenshot
How to install renforge
Platform CLI
claude mcp add renforge -- uvx renforgeuvx runs the command named after the package; if the README names another one, use uvx --from renforge <command>
Platform CLI
codex mcp add renforge -- uvx renforgeuvx runs the command named after the package; if the README names another one, use uvx --from renforge <command>
Config file
{
"mcpServers": {
"renforge": {
"command": "uvx",
"args": [
"renforge"
]
}
}
}uvx runs the command named after the package; if the README names another one, use uvx --from renforge <command>
Config file
{
"servers": {
"renforge": {
"type": "stdio",
"command": "uvx",
"args": [
"renforge"
]
}
}
}uvx runs the command named after the package; if the README names another one, use uvx --from renforge <command>
Platform CLI
gemini mcp add renforge uvx renforgeuvx runs the command named after the package; if the README names another one, use uvx --from renforge <command>
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about renforge
How do I install renforge in Claude Code?
Run claude mcp add renforge -- uvx renforge. The server starts through uvx, so there is nothing else to install.
What does renforge do?
It gives an agent access to a running Ren'Py game: project inspection, runtime state, screenshots, guarded clicks, source-safe UI edits, builds and Ren'Py doc search.
What does renforge need to run?
Python 3.11+ and uv. Ren'Py does not have to be installed — the server finds an SDK on disk or downloads one on first launch.
