# RPG Maker MV Ultimate MCP

Connects an AI assistant to RPG Maker MV project files to generate maps and verify event logic in live playtests.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 28
- Author: DiegoLopez0208
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/DiegoLopez0208/RpgMakerMVUltimate-MCP
- Updated: 2026-10-12
- HTML: https://affpapa.org/en/nevibecode/mcp/rpg-maker-mv-ultimate-mcp

## What it does

The server gives coding agents direct access to an MV project directory containing `data/`, `js/`, and `index.html`. Operating via 18 consolidated tools, the model reads raw JSON stores with actual item and map identifiers instead of guessing values. It isolates unreachable locations and uncovers dead event switches. Map generation provides two distinct strategies: procedural cloning from 106 built-in RTP templates, or semantic graph generation matching custom tilesets.

A browser bridge powered by Playwright and Chromium links the model to live execution. The assistant launches the game to inspect runtime exceptions. It captures screenshots and hot-reloads modified maps while preserving save files.

Shut down the RPG Maker MV desktop editor before letting an agent alter disk files. Conflicting writes will corrupt game data. Running the server requires Node.js 20.19.0 or later.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `RPGMAKER_PROJECT_PATH`, `VISION_API_URL`, `VISION_API_KEY`, `VISION_MODEL`, `RPGMV_LEGACY_TOOLS` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```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
```
Replace <…> with your own values

### Codex

**Platform CLI**
```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
```
Replace <…> with your own values

### Cursor

**Config file**
File `.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>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.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>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform 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
```
Replace <…> with your own values

## When to use it
- Diagnose broken event switches and unreachable map files
- Generate game locations via procedural templates or custom tilesets
- Execute headless playtests with runtime error monitoring
- Update database entries using real entity identifiers

## Example prompts
- Run analyze_project to list disconnected maps and broken switches
- Generate a 40x30 dungeon map using procedural mode
- Start a playtest session to confirm why the door event does not trigger

## Similar
- [godot-genre-action-rpg](https://affpapa.org/en/nevibecode/skills/godot-genre-action-rpg.md) — skill · 354 installs
- [browser-control](https://affpapa.org/en/nevibecode/skills/browser-control.md) — skill · 1000 installs
- [screenshot](https://affpapa.org/en/nevibecode/skills/zernie-screenshot.md) — skill · 337 installs
- [game-qa](https://affpapa.org/en/nevibecode/skills/game-qa.md) — skill · 1100 installs
- [qa-game](https://affpapa.org/en/nevibecode/skills/qa-game.md) — skill · 931 installs
- [CloakBrowser MCP](https://affpapa.org/en/nevibecode/mcp/cloakbrowser-mcp.md) — MCP server · ★ 171

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md