RPG Maker MV Ultimate MCP — MCP-сервер для Claude Code
Инспектирует файлы проектов RPG Maker MV, редактирует карты и проверяет логику событий в тестах.
claude mcp add --env RPGMAKER_PROJECT_PATH=<RPGMAKER_PROJECT_PATH> --env VISION_API_URL=<VISION_API_URL> --env VISION_API_KEY=<VISION_API_KEY> --env VISION_MODEL=<VISION_MODEL> --env RPGMV_LEGACY_TOOLS=<RPGMV_LEGACY_TOOLS> --transport stdio rpg-maker-mv-ultimate-mcp -- npx -y rpgmaker-mv-mcpЧто делает RPG Maker MV Ultimate MCP
Сервер связывает ИИ-агента с файловой структурой игры на диске, где лежат папки data/, js/ и файл index.html. Через набор из 18 инструментов модель считывает состояние базы данных и находит сломанные ссылки в событиях. Создание локаций работает в двух режимах: процедурном на базе 106 встроенных шаблонов RTP и смысловом под сторонние тайлсеты с контролем доступности сюжетных ключей.
Для проверки логики предусмотрен мост к движку на базе Playwright и Chromium. Агент запускает игру через браузер, перехватывает ошибки и перезагружает карту без потери сохранения.
Редактор игр нужно закрыть. Иначе одновременная запись файлов приведёт к сбою данных. Для работы сервера требуется Node.js версии не ниже 20.19.0.
Какие задачи решает
- Найти неработающие переключатели и разорванные связи в событиях
- Сгенерировать карту подземелья или города по готовому шаблону
- Проверить игровой процесс через запуск игры в браузере
- Отредактировать параметры базы данных по реальным числовым ID
Примеры запросов агенту
- Проверь проект с помощью analyze_project и найди недостижимые карты
- Сгенерируй карту подземелья размером 40 на 30 в процедурном режиме
- Запусти плейтест и выясни, почему не срабатывает событие открытия двери
Как установить RPG Maker MV Ultimate MCP
Командой платформы
claude mcp add --env RPGMAKER_PROJECT_PATH=<RPGMAKER_PROJECT_PATH> --env VISION_API_URL=<VISION_API_URL> --env VISION_API_KEY=<VISION_API_KEY> --env VISION_MODEL=<VISION_MODEL> --env RPGMV_LEGACY_TOOLS=<RPGMV_LEGACY_TOOLS> --transport stdio rpg-maker-mv-ultimate-mcp -- npx -y rpgmaker-mv-mcpВместо <…> подставьте свои значения
Командой платформы
codex mcp add rpg-maker-mv-ultimate-mcp --env RPGMAKER_PROJECT_PATH=<RPGMAKER_PROJECT_PATH> --env VISION_API_URL=<VISION_API_URL> --env VISION_API_KEY=<VISION_API_KEY> --env VISION_MODEL=<VISION_MODEL> --env RPGMV_LEGACY_TOOLS=<RPGMV_LEGACY_TOOLS> -- npx -y rpgmaker-mv-mcpВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"rpg-maker-mv-ultimate-mcp": {
"command": "npx",
"args": [
"-y",
"rpgmaker-mv-mcp"
],
"env": {
"RPGMAKER_PROJECT_PATH": "<RPGMAKER_PROJECT_PATH>",
"VISION_API_URL": "<VISION_API_URL>",
"VISION_API_KEY": "<VISION_API_KEY>",
"VISION_MODEL": "<VISION_MODEL>",
"RPGMV_LEGACY_TOOLS": "<RPGMV_LEGACY_TOOLS>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"rpg-maker-mv-ultimate-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"rpgmaker-mv-mcp"
],
"env": {
"RPGMAKER_PROJECT_PATH": "<RPGMAKER_PROJECT_PATH>",
"VISION_API_URL": "<VISION_API_URL>",
"VISION_API_KEY": "<VISION_API_KEY>",
"VISION_MODEL": "<VISION_MODEL>",
"RPGMV_LEGACY_TOOLS": "<RPGMV_LEGACY_TOOLS>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e RPGMAKER_PROJECT_PATH=<RPGMAKER_PROJECT_PATH> -e VISION_API_URL=<VISION_API_URL> -e VISION_API_KEY=<VISION_API_KEY> -e VISION_MODEL=<VISION_MODEL> -e RPGMV_LEGACY_TOOLS=<RPGMV_LEGACY_TOOLS> rpg-maker-mv-ultimate-mcp npx -y rpgmaker-mv-mcpВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о RPG Maker MV Ultimate MCP
Как установить RPG Maker MV Ultimate MCP в Claude Code?
Выполните команду `claude mcp add --env RPGMAKER_PROJECT_PATH=<RPGMAKER_PROJECT_PATH> --env VISION_API_URL=<VISION_API_URL> --env VISION_API_KEY=<VISION_API_KEY> --env VISION_MODEL=<VISION_MODEL> --env RPGMV_LEGACY_TOOLS=<RPGMV_LEGACY_TOOLS> --transport stdio rpg-maker-mv-ultimate-mcp -- npx -y rpgmaker-mv-mcp`.
Что делает RPG Maker MV Ultimate MCP?
Сервер предоставляет 18 инструментов для прямого чтения и изменения файлов проекта RPG Maker MV. Он генерирует карты, правит параметры объектов и запускает плейтесты в Chromium.
Что нужно подготовить перед запуском сервера?
Установите Node.js версии 20.19.0 или выше. Перед запуском правок обязательно закройте редактор RPG Maker MV, чтобы избежать конфликтов при перезаписи файлов.
