renforge — MCP-сервер для Claude Code: управление Ren'Py-игрой
MCP-сервер, CLI и веб-панель для проектов на Ren'Py: осмотр проекта, запуск игры, скриншоты, правки интерфейса прямо в работающей игре.
claude mcp add renforge -- uvx renforgeЧто делает renforge
RenForge подключается к агенту как MCP-сервер и даёт ему инструменты для работы с визуальной новеллой на Ren'Py. Агент осматривает структуру проекта, скрипты, метки и ассеты, запускает игру с включённым Live Editor, снимает скриншоты, читает дерево сцены и жмёт по элементам интерфейса. Через веб-панель то же самое может делать человек.
Live Editor — главная часть версии 0.7. Выделяешь элемент на экране, смотришь его свойства, двигаешь и сохраняешь в .rpy только тогда, когда цель безопасна для исходников. Заблокированные элементы остаются доступными для осмотра, и рядом видно причину блокировки. Есть карта сюжета с переходом по меткам и аудит ассетов: потерянные файлы, отсутствующие картинки.
Для запуска нужен Python 3.11+ и uv. Сам Ren'Py ставить не обязательно: RenForge берёт SDK, который уже лежит на машине, либо скачивает его при первом запуске. На Debian и Ubuntu обычный pip install заблокирован из-за PEP 668, поэтому ставьте через uvx или pipx. Статус проекта — alpha, API ещё меняются.
Какие задачи решает
- осмотреть структуру Ren'Py-проекта и найти потерянные ассеты
- запустить игру и снять скриншот текущей сцены
- подвинуть элемент интерфейса и сохранить правку в исходник
- пройти по меткам сюжета и проверить переходы
- собрать переводы и запустить сборку проекта
Примеры запросов агенту
- Осмотри мой Ren'Py-проект в
/path/to/game - Запусти игру и покажи дерево сцены
- Нажми на кнопку «Начать» и сделай скриншот
Как установить renforge
Командой платформы
claude mcp add renforge -- uvx renforgeuvx запускает команду с именем пакета; если в README она другая — uvx --from renforge <команда>
Командой платформы
codex mcp add renforge -- uvx renforgeuvx запускает команду с именем пакета; если в README она другая — uvx --from renforge <команда>
Файл настроек
{
"mcpServers": {
"renforge": {
"command": "uvx",
"args": [
"renforge"
]
}
}
}uvx запускает команду с именем пакета; если в README она другая — uvx --from renforge <команда>
Файл настроек
{
"servers": {
"renforge": {
"type": "stdio",
"command": "uvx",
"args": [
"renforge"
]
}
}
}uvx запускает команду с именем пакета; если в README она другая — uvx --from renforge <команда>
Командой платформы
gemini mcp add renforge uvx renforgeuvx запускает команду с именем пакета; если в README она другая — uvx --from renforge <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о renforge
Как установить renforge в Claude Code?
Одна команда: claude mcp add renforge -- uvx renforge. Сервер запустится через uvx, отдельная установка не нужна.
Что делает renforge?
Даёт агенту доступ к запущенной Ren'Py-игре: осмотр проекта, управление состоянием, скриншоты, клики по элементам, правки интерфейса с сохранением в исходники, сборки и поиск по документации Ren'Py.
Что нужно, чтобы renforge заработал?
Python 3.11+ и uv. Ren'Py можно не устанавливать: сервер найдёт SDK на диске или скачает его сам при первом запуске.
