RenForge
RenForge is an for working with visual-novel projects.
接入你的智能体
发布者自己的命令。不是 PlugMCP 端点。
用我们的密钥与日志托管一份副本。
uvx renforge==0.7.5Claude Code 没有针对本地命令的安装链接。复制下方命令并在终端中运行。
claude mcp add alex-jordan547-renforge-mcp -- uvx renforge==0.7.5在终端中运行。
{ "mcpServers": { "alex-jordan547-renforge-mcp": { "command": "uvx", "args": [ "renforge==0.7.5" ] } }}claude_desktop_config.json
远程 URL 还是本机命令? 两种安装方式的区别
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.
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.
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.
Full human and agent workflows, source-safety rules, and screenshots: docs/LIVE_EDITOR.md.
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.
What's new: CHANGELOG.md · GitHub releases.
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"]
}
}
}
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).
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.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.game/tl/<lang>/ files,
export dialogue as text.127.0.0.1:8765).renforge --version
renforge inspect <project> # lightweight project summary (JSON)
renforge serve [--project .] # start the MCP server (stdio transport)
renforge ui [--project <project>] [--port 8765] # start the web dashboard
ToolAnnotations, authorization, and the compatibility plan.examples/demo_game/ — small sample Ren'Py project to try everything on.MIT
Special thanks to the people who have contributed to RenForge:
MCP server, CLI, and web dashboard for Ren'Py visual-novel development — inspect, drive and debug a running game from an AI agent or the browser
{ "mcpServers": { "alex-jordan547-renforge-mcp": { "command": "uvx", "args": [ "renforge==0.7.5" ] } }}工具
暂无工具列表。远程服务器在首次健康检查后会获得工具列表。
常见问题
在本页复制适用于 Cursor、Claude Desktop、Claude Code 或 VS Code 的 stdio 配置。它使用发布者的安装方式,而不是 PlugMCP 代理。
此记录未列出必需的环境变量。
Renforge 通过 stdio 在本地运行。
上次检查时间:2026-11-15。 MCP server, CLI, and web dashboard for Ren'Py visual-novel development — inspect, drive and debug a running game from an AI agent or the browser