# rpgmaker-mv-mcp

Даёт ассистенту доступ к базе данных, картам и событиям проекта RPG Maker MV. Пригодится, когда надо править игру пачкой, а не мышкой в редакторе.

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

## Что делает

Сервер работает через Model Context Protocol и подключается к Claude, Claude Desktop, Cursor и другим MCP-клиентам. Внутри — набор инструментов для всех 12 типов базы данных (актёры, классы, скиллы, предметы, оружие, броня, враги, отряды, состояния, анимации, тайлсеты, общие события): читать, создавать, менять, удалять. Отдельно есть готовые сборщики скиллов — достаточно имени и формулы урона, чтобы получить валидную запись в редакторе.

Карты и события тоже под рукой: создать карту, добавить или поправить ивент, вставить пачку команд, собрать диалог с разбивкой по окнам сообщений. `render_map_image` рисует карту в PNG с настоящей графикой тайлсета, событиями и сеткой, так что модель видит результат, а не работает вслепую. `connect_maps` ставит переходы между двумя картами сразу в обе стороны. Для массовых правок есть `bulk_update_records` с предварительным диффом и `balance_report` с `simulate_battle` для проверки баланса.

Нужен Node.js 18 и выше. Каждый файл перед первой правкой за сессию уходит в `.mcp-backups/`, откат делает `restore_backup`, а `validate_project` ловит битые ссылки до сборки. При старте укажите `--project` с путём к папке игры, иначе придётся сначала звать `set_project`.

## Требования
- Нужно: Node.js (команды через npx)

## Установка

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

**Командой платформы**
```bash
claude mcp add rpgmaker-mv-mcp -- npx -y @xerolo44/rpgmaker-mv-mcp
```

### Codex

**Командой платформы**
```bash
codex mcp add rpgmaker-mv-mcp -- npx -y @xerolo44/rpgmaker-mv-mcp
```

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "rpgmaker-mv-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@xerolo44/rpgmaker-mv-mcp"
            ]
        }
    }
}
```

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "rpgmaker-mv-mcp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@xerolo44/rpgmaker-mv-mcp"
            ]
        }
    }
}
```

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add rpgmaker-mv-mcp npx -y @xerolo44/rpgmaker-mv-mcp
```

## Когда брать
- создать скилл с формулой урона через ассистента
- найти все события, где упоминается нужный персонаж
- покрасить карту водой и стенами без ручной кисти
- перебалансировать оружие с предварительным диффом
- вынести весь текст игры в CSV и залить обратно

## Примеры запросов агенту
- Создай скилл «Огненный шар»: магический урон, `a.mat * 4 - b.mdf * 2`, 12 MP, огненная стихия.
- Найди все ивенты на всех картах, где упоминается мэр.
- Соедини карту замка и подземелья переходами в обе стороны.

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

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