RenForge

<!-- mcp-name: io.github.alex-jordan547/renforge -->

RenForge is an MCP (Model Context Protocol) server, CLI, and web dashboard for working with Ren'Py visual-novel projects.

It lets an AI agent — or a human via the dashboard — inspect a project, launch and drive a running game, read/write game state, capture screenshots, generate translations, find orphaned assets, run builds, and search Ren'Py's docs.

Status: alpha, actively developed. The core surfaces (MCP tools, in-game bridge, CLI, dashboard) are functional; APIs may still change.

<picture> <source media="(prefers-color-scheme: dark)" srcset=".github/screenshots/live-dark.png" /> <img src=".github/screenshots/live.png" alt="RenForge dashboard — live control of a running game" /> </picture> <table> <tr> <td width="50%"> <picture> <source media="(prefers-color-scheme: dark)" srcset=".github/screenshots/storymap-dark.png" /> <img src=".github/screenshots/storymap.png" alt="Story map — interactive graph of labels and transitions" /> </picture> </td> <td width="50%"> <picture> <source media="(prefers-color-scheme: dark)" srcset=".github/screenshots/assets-dark.png" /> <img src=".github/screenshots/assets.png" alt="Assets — orphaned, missing and undefined asset audit" /> </picture> </td> </tr> <tr> <td align="center"><em>Story map — click a node to warp the running game</em></td> <td align="center"><em>Asset audit — orphans, missing files, undefined images</em></td> </tr> </table>

Quick start — dashboard

Requires Python 3.11+ and uv — nothing else. You don't even need Ren'Py installed: RenForge reuses an SDK it finds on your machine, or downloads one automatically on first launch.

uvx --from "renforge[ui]@latest" renforge ui

Then choose your game in the dashboard's project picker — no path to type. (Or skip the picker with --project /path/to/your/game.)

Install

uvx needs no install at all. For a persistent renforge command on your PATH, use pipx:

# Full install — MCP + CLI + web dashboard
pipx install "renforge[ui]"
renforge ui

# Slim install — MCP server + CLI only (no dashboard deps)
pipx install renforge
renforge serve

[ui] pulls in the optional dashboard stack (Starlette, uvicorn, watchfiles). Skip it if you only need the MCP server or CLI.

On managed systems (Debian/Ubuntu), plain pip install is blocked by PEP 668 — use uvx or pipx instead.

Update

Installed with	How to update
uvx … @latest	Nothing to do — @latest fetches the newest release on each start
pipx (full or slim)	pipx upgrade renforge
pip / venv	pip install -U "renforge[ui]" (or renforge for slim)

What's new: CHANGELOG.md · GitHub releases.

Set up the MCP server (AI agents)

The server command is the same for every client:

uvx renforge@latest serve

Every RenForge tool takes a project_path argument, so the agent passes your game's path on each call — copy the configs below as-is, no path substitution.

Claude Code

claude mcp add renforge -- uvx renforge@latest serve

Codex CLI

codex mcp add renforge -- uvx renforge@latest serve

Claude Desktop, Cursor, Windsurf, Cline, Gemini CLI — same mcpServers JSON shape in each clien