Renforge

Name: Renforge
Author: alex-jordan547

by alex-jordan547version 0.7.3i★ –iRuns on your computer

Registry nameio.github.alex-jordan547/renforge

Install

Overview

Description from the maker (original English)

Inspect, drive and debug a running Ren'Py game: state, screenshots, guarded clicks, saves, builds.

PopNx MCP’s three pillars

These three are never merged into one score: opinions, measurements and popularity are different things.

User voiceiNo reviews yetReviews open together with accounts in a later step
Our basic checksi1 of 1 passedChecked from public information; code not scanned yet
UsageiNot measured yet★ –

What you can do with it

We have not written a plain-language summary for this one yet. Below are the facts we read from the registry.

Connection: Runs on your computer
Transport: stdio
Category: Games, sports, food & learning

Install

Pick the AI app you use, then copy the settings.

Before you install

Basic checks: 1 of 1 passed
Runs on your computer with your user’s permissions (files, network, apps).
The registry lists no key to fill in.

You need

PyPIPython’s uv installed (for the uvx command)

Which app do you use?

ClaudeClaude CodeCursorVS CodeChatGPT

Pick your app above. We remember it, so next time the button says “Install in …”.

Open Claude Desktop → Settings → Developer → Edit Config, and paste this into claude_desktop_config.json

{
  "mcpServers": {
    "renforge": {
      "command": "uvx",
      "args": [
        "renforge",
        "serve"
      ]
    }
  }
}

Run this in your terminal

claude mcp add renforge -- uvx renforge serve

Open in Cursor

Or copy the settings yourself

Paste into .cursor/mcp.json in your project, or ~/.cursor/mcp.json

{
  "mcpServers": {
    "renforge": {
      "command": "uvx",
      "args": [
        "renforge",
        "serve"
      ]
    }
  }
}

Your browser asks to open the app, then the app shows the settings and asks you to confirm. Key values are left empty for you to fill in.

Open in VS Code

Or copy the settings yourself

Paste into .vscode/mcp.json in your project

{
  "servers": {
    "renforge": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "renforge",
        "serve"
      ]
    }
  }
}

Your browser asks to open the app, then the app shows the settings and asks you to confirm. Key values are left empty for you to fill in.

This one runs on your computer, and ChatGPT can only connect to servers on the internet. Pick another app.

Your choice stays on this device in a cookie; no account needed.

These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.

What it can do

Runs on your computer; the tool list appears in your AI app after you install it.

Basic checksi

We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 7, 2026

✓ Pass
Maker matches the repo
The registry name was verified with the GitHub account alex-jordan547, which owns the repo
… Not checked yet
Still maintained
We have not read this repo from GitHub yet
… Not checked yet
Has a licence
We have not read this repo from GitHub yet
– Not applicable
Endpoint responds
This one runs on your computer; there is no internet endpoint
– Not applicable
Sign-in with OAuth
Runs on your computer and uses local settings instead
… Not checked yet
No hidden instructions in tool descriptions
Runs on your computer; we can only read tool lists from internet endpoints

Compared with others in Games, sports, food & learningi

More stars than 0% of the other 1283 servers in this category
Published to the registry more recently than 48% of the other 1283 servers in this category
Basic checks equal to or better than 100% of the other 1283 servers in this category

Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.

Common questions

Is Renforge safe?

It passed 1 of 1 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.

What keys or codes does it need?

The registry does not list a required key, though some servers ask you to sign in on first use.

Does it run on my computer or in the cloud?

It runs on your computer. Your AI app starts it when needed, and data does not pass through the maker’s servers (unless it calls an online service itself).

Is it still maintained?

The GitHub repo last changed –, and the latest version (0.7.3) reached the registry 32 days ago.

Which apps can use it?

Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. You also need Python (uv) on your computer.

What can I use instead?

In the same category: Neural Cosmology, slopped.site, Artsonia MCP

Alternatives

Servers in the same category from other makers, sorted by stars.

Reading a card:★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi

Neural Cosmology

by neuralcosmology.com

Answers, essays, experiments and books on consciousness and cosmology: search, read, buy.

Runs in the cloudUpdated today

Install

slopped.site

by slopped.site

Read-only tools over slopped.site: AI-made art, lore, games, sites, the curriculum.

Runs in the cloudUpdated today

Install

Artsonia MCP

by chrischall

Parent/fan access to Artsonia student-art portfolios, comments, and fans (AI-built).

Runs on your computerUpdated today

Install

README from the maker

Open the README

Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.

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 a game with the Live Editor enabled by default, select and inspect on-screen controls, preview layout changes before writing guarded .rpy source, drive runtime 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, Live Editor, CLI, dashboard) are functional; APIs may still change.

Live Editor — select an editable control, inspect it, preview moves, then Save to source

Dashboard — live control of a running game Live Editor — locked targets stay inspectable with a clear reason

Story map — click a node to warp the running game Asset audit — orphans, missing files, undefined images

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.) Launch the game and click the floating RF control to open the Live Editor.

Live Editor

The Live Editor is the headline 0.7 feature: edit eligible on-screen controls inside the running game, preview layout changes at runtime, and Save only when a target is source-safe. Locked or unsupported targets stay inspectable with a clear reason — they are not silently forced.

Audience	Start here
Human	Dashboard or game window → launch → click RF → select from canvas or scene tree → inspect / move where editable → Save → stop cleanly.
AI agent	`renforge_info` (read `live_editor`) → `renforge_launch` → poll `renforge_launch_status` → `renforge_screenshot` / `renforge_scene_tree` → guarded `renforge_click_at` or `renforge_click_element` → verify → `renforge_stop`.

Full human and agent workflows, source-safety rules, and screenshots: [docs/LIVE_EDITOR.md](docs/LIVE_EDITOR.md).

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 client's config file:

"mcpServers": { "renforge": { "command": "uvx", "args": ["renforge@latest", "serve"] } } }

Client	Config file
Claude Desktop	`claude_desktop_config.json`
Cursor	`.cursor/mcp.json`
Windsurf	`~/.codeium/windsurf/mcp_config.json`
Cline	`cline_mcp_settings.json`
Gemini CLI	`~/.gemini/settings.json`

VS Code (Copilot), Zed, Windows PATH issues, and the pipx variant are covered in the MCP guide.

Verify it works — ask the agent:

Inspect my Ren'Py project at /path/to/game

The agent should call renforge_inspect_project with that path and return a JSON summary of the project (labels, scripts, assets, and related metadata).

What it does

Live Editor (default on launch) — in-game selection, inspection, and source-safe preview/Save for editable controls; locked targets stay inspectable. Guide: docs/LIVE_EDITOR.md.
Project inspection — summarize structure, scan scripts/labels/assets, parse lint output.
Live game control — launch a project with an injected in-game bridge and Live Editor, then advance dialogue, list/select choices, evaluate expressions, get/set store variables, send focused text/key/scroll input, poll pushed events, and capture frames the model can literally see.
Scene perception (pixel-perfect, no vision needed) — read the whole frame as structured logical-coordinate nodes (renforge_scene_tree): every sprite, control, and text block with bounds, z-order, colour, and style, plus an ASCII wireframe and structural scene diffs. Then renforge_measure reports alignment, spacing, overlap, fit, and WCAG contrast as numbers an agent can act on.
Autopilot — auto-play choices backed by Ren'Py menu items across fresh replays, including custom-named and one-item menus, while reporting label coverage and crashes. Custom call_screen interactions that do not expose Ren'Py menu items are not currently explored automatically.
Assets & translations — find orphaned/missing image+audio assets, list languages, compute translation stats, generate/update game/tl/ / files, export dialogue as text.
Builds — package desktop distributions and web builds.
Docs — search and read Ren'Py's offline documentation.
Web dashboard — live story map, activity log, autopilot coverage, lint view, and game-state controls (default 127.0.0.1:8765).

CLI

renforge --version

renforge inspect # lightweight project summary (JSON) renforge serve [--project .] # start the MCP server (stdio transport) renforge ui [--project ] [--port 8765] # start the web dashboard

Documentation

[Live Editor](docs/LIVE_EDITOR.md) — human and agent workflows, editable vs locked targets, source-safety, public screenshots.
[MCP guide](docs/MCP.md) — full tool catalogue, agent workflows (Live Editor, hot reload, saves, pixel-perfect placement, scene perception).
[Runtime policy](docs/POLICY.md) — operation-level risk enforcement vs MCP ToolAnnotations, authorization, and the compatibility plan.
[Architecture](docs/ARCHITECTURE.md) — code layout, live-control flow, Ren'Py SDK resolution, packaging.
[Contributing](CONTRIBUTING.md) — dev setup, frontend build, PRs.
[Cloud / CI environment](docs/CLOUD_ENVIRONMENT.md) — Cursor Cloud Agents, Xvfb, Ren'Py SDK bootstrap, and env smoke.
[Changelog](CHANGELOG.md) — release history.
examples/demo_game/ — small sample Ren'Py project to try everything on.

License

MIT

Contributors

Special thanks to the people who have contributed to RenForge:

@AxelBeary — complete Simplified Chinese dashboard translation and related internationalization fixes.

Renforge

Overview

PopNx MCP’s three pillars

What you can do with it

Install

Before you install

What it can do

Basic checksi

Maker matches the repo

Still maintained

Has a licence

Endpoint responds

Sign-in with OAuth

No hidden instructions in tool descriptions

Compared with others in Games, sports, food & learningi

Common questions

Alternatives

Neural Cosmology

slopped.site

Artsonia MCP

README from the maker

RenForge

Quick start — dashboard

Live Editor

Install

Slim install — MCP server + CLI only (no dashboard deps)

Update

Set up the MCP server (AI agents)

What it does

CLI

Documentation

License

Contributors