renpy-mcp
renpy-mcp
Un servidor MCP que permite a los asistentes de edición (Claude Code, Cursor, Copilot, Codex, Zed y cualquier otra cosa que hable MCP) trabajar en un proyecto de Ren'Py a través de la línea de comandos del SDK de Ren'Py, en lugar de adivinar las invocaciones de renpy.sh.
Cada herramienta es una capa fina sobre un comando que el SDK ya tiene. Aquí no se reimplementa nada del motor.
Contexto: renpy/renpy#7313.
Herramientas
Herramienta | Qué ejecuta | Qué devuelve |
|
| Problemas como |
|
| Etiquetas, pantallas, transforms y defines con archivo y línea; nombre, versión, resolución; el grafo de flujo de etiquetas donde el SDK lo exporta (#7318). |
|
| El flujo de una etiqueta: saltos, llamadas, menús y sus opciones, flujo continuado (fall-through) y qué etiquetas llegan a ella. |
|
| Errores de parseo como |
|
| Estado aprobado/fallido, el resumen |
| lee archivos |
|
| cualquier cosa | Ejecuta cualquier comando CLI ( |
|
| Qué SDK está en uso. |
Related MCP server: Godot MCP
Configuración
Necesitas un SDK de Ren'Py (8.x) descomprimido en algún lugar y Python 3.10+.
uv tool install renpy-mcp # or: pipx install renpy-mcp
renpy-mcp --check # confirms which SDK it foundEl SDK se busca mediante --sdk, luego la variable de entorno RENPY_SDK y, después, en los lugares habituales (tu directorio personal, Download, /opt, /Applications, C:\). Si --check encuentra el lugar, establece RENPY_SDK.
Claude Code
claude mcp add renpy -- renpy-mcp --sdk /path/to/renpy-8.5.3-sdkCursor / VS Code / otros
Añade una entrada de servidor stdio:
{
"mcpServers": {
"renpy": {
"command": "renpy-mcp",
"args": ["--sdk", "/path/to/renpy-8.5.3-sdk"]
}
}
}Desde un checkout
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 SDKNotas
Las rutas pasadas como
projectson el directorio base del proyecto (el que contienegame). Apuntar agameen sí mismo también funciona.renpy_run_testsy cualquier cosa que inicie el juego necesitan una pantalla. Todo lo demás se ejecuta con controladores de vídeo y audio simulados, algo que el SDK hace por sí solo para esos comandos.La salida está limitada a 20 000 caracteres por campo; se descarta el principio, no el final, que es donde suele estar el error.
La CLI del SDK no es una interfaz estable, y esta tampoco. Las herramientas siguen la documentación CLI de la versión actual.
Licencia
MIT.
This server cannot be deployed
Maintenance
Related MCP Connectors
- ApricotOAuthtools.apricot
Manage SysML2 projects; check, evaluate, verify, query, document and diagram models.
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…
Build, run and publish Workbench flows, tasks, shims and knowledge bases.
Related MCP Servers
- AlicenseNot gradedqualityNot gradedmaintenanceEnables comprehensive management of TyranoStudio visual novel projects including project creation, scenario editing with syntax validation, resource management, and TyranoScript development assistance. Supports project analysis, template generation, and Git integration for visual novel game development.2-
- AlicenseAqualityDmaintenanceEnables AI assistants to interact with the Godot game engine by launching the editor, running projects, capturing debug output, managing scenes and nodes, and controlling project execution through a standardized interface.18201 npm11MIT
- AlicenseBqualityNot gradedmaintenanceEnables AI assistants to interact with the Godot game engine by launching the editor, running projects, capturing debug output, managing scenes and nodes, and controlling project execution through a standardized interface.14201 npm1-
- AlicenseBqualityCmaintenanceEnables AI assistants to interact with the Godot game engine, including launching the editor, running projects, capturing debug output, and managing scenes.8474 PyPI1MIT