renpy-mcp

エディタアシスタント（Claude Code、Cursor、Copilot、Codex、Zed、その他MCPに対応しているもの）が、renpy.sh の呼び出しを推測しなくても、Ren'Py SDKのコマンドラインを通じてRen'Pyプロジェクトを操作できるようにするMCPサーバーです。

各ツールは、SDKがすでに持っているコマンドの薄いラッパーです。ここでエンジンを再実装することはありません。

背景: renpy/renpy#7313。

ツール

Related MCP server: Godot MCP

セットアップ

Ren'Py SDK（8.x）をどこかに展開しておくことと、Python 3.10+が必要です。

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

SDKは、--sdk、次にRENPY_SDK環境変数、その後に一般的な場所（ホームディレクトリ、Downloads、/opt、/Applications、C:\）の順で検索されます。--checkが誤ったSDKを発見した場合は、RENPY_SDKを設定してください。

Claude Code

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

Cursor / VS Code / その他

stdioサーバーのエントリを追加します:

{
  "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 SDK

メモ

• projectとして渡すパスは、プロジェクトのベースディレクトリ（gameがその中にあるもの）です。game自体を指定しても機能します。

• renpy_run_last_tracebackと、ゲームを起動するコマンドにはディプレイが必要です。それ以外は、SDKがそれらのコマンドで独自に使用するダミーのビデオ/オーディオドライバで実行されるためです。

• 各フィールドの出力は20,000文字に制限されています。エラーは通常の末尾に現れるため、切り捨てられるのは末尾ではなく、先頭側です。

• SDKのCLIは安定したインターフェイスではなく、このサーバーも同様です。ツールは現行リリースのCLIドキュメントに追従しています。

ライセンス

MIT。