# renforge

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.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 11
- Author: alex-jordan547
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/alex-jordan547/renforge-mcp
- Updated: 2026-10-06
- HTML: https://affpapa.org/en/nevibecode/mcp/renforge

## What it 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.

## Requirements
- Needs: Python and uv (commands run via uvx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add renforge -- uvx renforge
```
uvx runs the command named after the package; if the README names another one, use uvx --from renforge <command>

### Codex

**Platform CLI**
```bash
codex mcp add renforge -- uvx renforge
```
uvx runs the command named after the package; if the README names another one, use uvx --from renforge <command>

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "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>

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "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>

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add renforge uvx renforge
```
uvx runs the command named after the package; if the README names another one, use uvx --from renforge <command>

## When to use it
- 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
- 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

## Similar
- [Pascal 3D Editor](https://affpapa.org/en/nevibecode/mcp/pascal-3d-editor.md) — MCP server · ★ 25085
- [Unity-MCP](https://affpapa.org/en/nevibecode/mcp/unity-mcp.md) — MCP server · ★ 4523
- [mcp](https://affpapa.org/en/nevibecode/mcp/sceneview-mcp.md) — MCP server · ★ 1348
- [Gearboy MCP Server](https://affpapa.org/en/nevibecode/mcp/gearboy-mcp-server.md) — MCP server · ★ 1219
- [ChiR24-unreal_mcp_server](https://affpapa.org/en/nevibecode/mcp/chir24-unreal-mcp-server.md) — MCP server · ★ 975
- [Nova3D](https://affpapa.org/en/nevibecode/mcp/nova3d.md) — MCP server · ★ 733

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md