RPG Maker MV Ultimate MCP — Claude Code MCP Server Setup
Connects an AI assistant to RPG Maker MV project files to generate maps and verify event logic in live playtests.
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-mcpWhat RPG Maker MV Ultimate MCP 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.
What it helps with
- 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 for the agent
- 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
How to install RPG Maker MV Ultimate MCP
Platform CLI
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-mcpReplace <…> with your own values
Platform CLI
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-mcpReplace <…> with your own values
Config file
{
"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
Config file
{
"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
Platform CLI
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-mcpReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about RPG Maker MV Ultimate MCP
How to install RPG Maker MV Ultimate MCP in Claude Code?
Run `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`.
What does RPG Maker MV Ultimate MCP do?
It gives AI models 18 tools to inspect and modify RPG Maker MV project files directly on disk. It handles layout generation, database edits, and playtesting via Chromium.
What prerequisites are required to run this server?
Install Node.js 20.19.0 or newer. Close the graphical RPG Maker MV desktop editor during automated edits so conflicting writes do not corrupt game files.
