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

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 found

El 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-sdk

Cursor / 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 SDK

Notas

• Las rutas pasadas como project son el directorio base del proyecto (el que contiene game). Apuntar a game en sí mismo también funciona.

• renpy_run_tests y 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.