rpgmaker-mz-mcp — MCP-сервер для Claude Code: правит проект RPG Maker
MCP-сервер, через который ИИ-ассистент вносит правки в проект RPG Maker MZ: база данных, карты, тайлы, события. Пригодится, когда надоело кликать в редакторе.
claude mcp add --env RPGMAKER_PROJECT_PATH=<RPGMAKER_PROJECT_PATH> --transport stdio rpgmaker-mz-mcp -- npx -y rpgmaker-mz-mcpЧто делает rpgmaker-mz-mcp
Сервер открывает ассистенту доступ к файлам проекта: актёры, классы, навыки, предметы, экипировка, состояния, враги и отряды, общие события, карты с тайлами и тайлсетами, системные настройки. Для создания записи хватает имени, остальные поля берутся из шаблона редактора. Новые карты прописываются в MapInfos.json так, как этого ждёт движок.
Живопись тайлов автоматическая: paint_tiles и fill_area расставляют тайлы на шести слоях карты и сами пересчитывают формы автотайлов по соседям. paint_blueprint заливает область по ASCII-строкам с легендой, place_object ставит многоклеточные объекты из B/C и показывает их проходимость. Название тайла ищется словами: find_tile "grass" вернёт пригодный id из каталогов стандартных тайлсетов. Проверить сборку можно до запуска игры — render_map рисует карту как движок, а run_playtest гоняет сценарий без окна.
Перед стартом задайте путь к проекту в RPGMAKER_PROJECT_PATH: это каталог с game.rmmzproject и папкой data/, где лежит System.json. Без этой переменной серверу нечего открывать. Записи проходят проверку схемы, а структурно неверная команда события отклоняется — сохранить её всё равно не дадут.
Какие задачи решает
- добавить в базу данных новых врагов и предметы, не открывая редактор
- залить участок карты травой с корректными автотайлами по краям
- поставить дом или дерево и сразу увидеть, что проходимость не сломана
- собрать диалог с ветвлениями и выбором ответа на странице события
- проверить карту скриншотом и прогоном сценария до запуска игры
Примеры запросов агенту
- Найди тайл травы и залей им область под городом на карте
Map003 - Сделай торговца зельями в новой комнате под мировой картой
- Проверь ссылки в проекте через
validate_referencesи покажи, что сломалось
Как установить rpgmaker-mz-mcp
Командой платформы
claude mcp add --env RPGMAKER_PROJECT_PATH=<RPGMAKER_PROJECT_PATH> --transport stdio rpgmaker-mz-mcp -- npx -y rpgmaker-mz-mcpВместо <…> подставьте свои значения
Командой платформы
codex mcp add rpgmaker-mz-mcp --env RPGMAKER_PROJECT_PATH=<RPGMAKER_PROJECT_PATH> -- npx -y rpgmaker-mz-mcpВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"rpgmaker-mz-mcp": {
"command": "npx",
"args": [
"-y",
"rpgmaker-mz-mcp"
],
"env": {
"RPGMAKER_PROJECT_PATH": "<RPGMAKER_PROJECT_PATH>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"rpgmaker-mz-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"rpgmaker-mz-mcp"
],
"env": {
"RPGMAKER_PROJECT_PATH": "<RPGMAKER_PROJECT_PATH>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e RPGMAKER_PROJECT_PATH=<RPGMAKER_PROJECT_PATH> rpgmaker-mz-mcp npx -y rpgmaker-mz-mcpВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о rpgmaker-mz-mcp
Как установить rpgmaker-mz-mcp в Claude Code?
Двумя командами: claude mcp add rpgmaker-mz-mcp -- npx -y rpgmaker-mz-mcp, затем claude mcp add --env RPGMAKER_PROJECT_PATH=<RPGMAKER_PROJECT_PATH> --transport stdio rpgmaker-mz-mcp -- npx -y rpgmaker-mz-mcp.
Что делает rpgmaker-mz-mcp?
Даёт ИИ-ассистенту инструменты для чтения и правки данных проекта RPG Maker MZ: база данных, карты, тайлы, события. Ещё он проверяет записи и умеет отрисовать карту или прогнать плeйтест.
Что нужно, чтобы сервер заработал?
Путь к проекту в переменной RPGMAKER_PROJECT_PATH. Каталог должен содержать game.rmmzproject и data/ с System.json.
