Provides integration with Ren'Py projects through the Ren'Py SDK, enabling linting, project information and flow analysis, compilation, test running, traceback reading, and arbitrary Ren'Py CLI commands.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@renpy-mcp Run lint on my Ren'Py project and summarize the problems"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
An MCP server that lets editor assistants (Claude Code, Cursor, Copilot, Codex, Zed, and anything else that speaks MCP) work on a Ren'Py project through the Ren'Py SDK's command line, instead of guessing at renpy.sh invocations.
Every tool is a thin wrapper over a command the SDK already has. Nothing here reimplements the engine.
Background: renpy/renpy#7313.
Tool | What it runs | What you get back |
|
| Problems as |
|
| Labels, screens, transforms, and defines with file and line; name, version, resolution; the label flow graph where the SDK exports it (#7318). |
|
| The flow for one label: jumps, calls, menus and their choices, fall-through, plus which labels reach it. |
|
| Parse errors as |
|
| Pass/fail status, the |
| reads files |
|
| anything | Runs any CLI command ( |
|
| Which SDK is in use. |
Related MCP server: Godot MCP
You need a Ren'Py SDK (8.x) unpacked somewhere, and Python 3.10+.
uv tool install renpy-mcp # or: pipx install renpy-mcp
renpy-mcp --check # confirms which SDK it foundThe SDK is found from --sdk, then the RENPY_SDK environment variable, then a search of the usual places (your home directory, Downloads, /opt, /Applications, C:\). If --check finds the wrong one, set RENPY_SDK.
claude mcp add renpy -- renpy-mcp --sdk /path/to/renpy-8.5.3-sdkAdd a stdio server entry:
{
"mcpServers": {
"renpy": {
"command": "renpy-mcp",
"args": ["--sdk", "/path/to/renpy-8.5.3-sdk"]
}
}
}uv run renpy-mcp --sdk /path/to/sdk --check
uv run pytest # parser tests
RENPY_SDK=/path/to/sdk uv run pytest # plus the tests that drive the real SDKPaths passed as project are the project's base directory (the one with game in it). Pointing at game itself also works.
renpy_run_tests and anything that starts the game need a display. Everything else runs with dummy video and audio drivers, which the SDK does on its own for those commands.
Output is capped at 20,000 characters per field; the head is dropped, not the tail, since that's where the error usually is.
The SDK's CLI isn't a stable interface, and neither is this. The tools track the CLI documentation for the current release.
MIT.
This server cannot be deployed
Lean 4 MCP server: compile, prove theorems, and formalize math with Mathlib.
Control Unreal Engine to browse assets, import content, and manage levels and sequences. Automate…
Develop, manage, and debug Railway projects, services, and deployments from within agents.
Manage SysML2 projects and files directly through your coding agent.
