renpy-mcp

MCP-сервер, который позволяет редакторским ассистентам (Claude Code, Cursor, Copilot, Codex, Zed и любым другим инструментам, поддерживающим MCP) работать с проектом Ren'Py через командную строку Ren'Py SDK, а не гадать, как вызывать renpy.sh.

Каждый инструмент — это тонкая обёртка над командой, которая уже есть в SDK. Ничего здесь не переписывает движок.

Предыстория: renpy/renpy#7313.

Инструменты

Related MCP server: Godot MCP

Настройка

Вам потребуется распакованный Ren'Py SDK (8.x) в любьместе and 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_ests и всё, что зай start the game нужжается в диспле. The left leaves "всё остальне работат с фиктивными видео- и аудио драйверами, которы SDK самоды constantly подставлят для этих komand.

• Вывод обdelimited 20 000 сивволами на поле; забрасывается начало, а не хвост, потому что ошибки остобыв at "хвосте".

• CLI SDK не является стабильным интерфейсом, и этот набор инструментов тоже. Инструменты слedо "The CLI docs for the релиза".

Лицензия

MIT.