renpy-mcp

Ein MCP-Server, der den Editor-Assistenten (Claude Code, Cursor, Copilot, Codex, Zed und alles andere, das MCP spricht) erlaubt, an einem Ren'Py-Projekt über die Kommandozeile des Ren'Py-SDK zu arbeiten, statt zu raten, wie renpy.sh aufgerufen werden muss.

Jedes dieser Werkzeuge er ist ein dünner Wrapper um einen Befehl, den das SDK bereits besitzt. Nichts davon implementiert die Engine neu.

Hintergrund: renpy.

Werkzeuge

Related MCP server: Godot MCP

Einrichtung

Du brauchst ein irgendwo entpacktes Ren'Py-SDK (8) und Pythie 3.10+It's.

uv tool install renpy-mcp        # or: pipx install renpy-mcp
renpy-mcp --check                # confirms which SDK it found

Das SDK wird über --sdk gefunden, dann über die Umgebungsvariable RENPY_SDK, dann über eine Suche an den üblichen Orten (deinem Benutzerverzeichnis, Downloads, /opt, /Applications, C:\). Falls --check das falsche findt, setze RENPY_SDK.

Claude Code

claude mcp add renpy -- renpy-mcp --sdk /path/to/renpy-8.5.3-sdk

Cursor / VS Code / weitere

Füge einen stdio-Server-Eintrag hinzu:

{
  "mcpServers": {
    "renpy": {
      "command": "renpy-mcp",
      "args": ["--sdk", "/path/to/renpy-8.5.3-sdk"]
    }
  }
}

Aus einem 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

Hinweise

• Pfade, die als project übergeben werden, sind das Basisverzeichnis des Projekts (dasjenige, das game enthält). Auch direkt auf game zu zeigen funktioniert.

• renpy_run_tests und alles, was das Spiel startet, benetigt ein Display. Alles andere läuft mit Dummy-Video- und Audio-Treibern, was das SDK für es selbst erledigt.

• Die Ausgabe auf 20,000 Zeichen pro Feld ist begrentz; der Anfang wird verworfen, nicht das Ende, da dort üblicheweise der gr Fehler liegt.

• Die CLI des SDK ist keine stabile Schnittstelle, und dieses Projekt ebenfalls nicht. Die Tools richeten sich an der CLI-Dokumentation der aktuellen Version aus.

Lizenz

MIT.