# RPG Maker MV Ultimate MCP

Инспектирует файлы проектов RPG Maker MV, редактирует карты и проверяет логику событий в тестах.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 28
- Автор: DiegoLopez0208
- Лицензия: MIT · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/DiegoLopez0208/RpgMakerMVUltimate-MCP
- Обновлён: 2026-10-12
- HTML: https://affpapa.org/nevibecode/mcp/rpg-maker-mv-ultimate-mcp

## Что делает

Сервер связывает ИИ-агента с файловой структурой игры на диске, где лежат папки `data/`, `js/` и файл `index.html`. Через набор из 18 инструментов модель считывает состояние базы данных и находит сломанные ссылки в событиях. Создание локаций работает в двух режимах: процедурном на базе 106 встроенных шаблонов RTP и смысловом под сторонние тайлсеты с контролем доступности сюжетных ключей.

Для проверки логики предусмотрен мост к движку на базе Playwright и Chromium. Агент запускает игру через браузер, перехватывает ошибки и перезагружает карту без потери сохранения.

Редактор игр нужно закрыть. Иначе одновременная запись файлов приведёт к сбою данных. Для работы сервера требуется Node.js версии не ниже 20.19.0.

## Требования
- Нужно: Node.js (команды через npx)
- Переменные окружения: `RPGMAKER_PROJECT_PATH`, `VISION_API_URL`, `VISION_API_KEY`, `VISION_MODEL`, `RPGMV_LEGACY_TOOLS` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

### Claude Code (родная платформа)

**Командой платформы**
```bash
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

**Командой платформы**
```bash
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
```
Вместо <…> подставьте свои значения

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "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>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "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 CLI

**Командой платформы**
```bash
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
```
Вместо <…> подставьте свои значения

## Когда брать
- Найти неработающие переключатели и разорванные связи в событиях
- Сгенерировать карту подземелья или города по готовому шаблону
- Проверить игровой процесс через запуск игры в браузере
- Отредактировать параметры базы данных по реальным числовым ID

## Примеры запросов агенту
- Проверь проект с помощью analyze_project и найди недостижимые карты
- Сгенерируй карту подземелья размером 40 на 30 в процедурном режиме
- Запусти плейтест и выясни, почему не срабатывает событие открытия двери

## Похожие
- [Pascal 3D Editor](https://affpapa.org/nevibecode/mcp/pascal-3d-editor.md) — MCP-сервер · ★ 25085
- [Unity-MCP](https://affpapa.org/nevibecode/mcp/unity-mcp.md) — MCP-сервер · ★ 4523
- [mcp](https://affpapa.org/nevibecode/mcp/sceneview-mcp.md) — MCP-сервер · ★ 1348
- [Gearboy MCP Server](https://affpapa.org/nevibecode/mcp/gearboy-mcp-server.md) — MCP-сервер · ★ 1219
- [ChiR24-unreal_mcp_server](https://affpapa.org/nevibecode/mcp/chir24-unreal-mcp-server.md) — MCP-сервер · ★ 975
- [Nova3D](https://affpapa.org/nevibecode/mcp/nova3d.md) — MCP-сервер · ★ 733

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md