Best for
- Game developers working with RPG Maker MV
- Those who want AI-assisted level design and event scripting
- AI agents that need to interact with the project structure via MCP
R
RPG Maker MV Ultimate MCP
Community
AI copilot for RPG Maker MV: generate maps, edit database & events, and understand your project.
GitHub source repository ↗
58FMRS · C
This server extends the MCP ecosystem to RPG Maker MV, offering unique template-based map generation and project intelligence. The 13 tools cover CRUD, map editing, event management, and system operations. Highlights include knowledge-driven map generation (cloning templates), read-only project analysis (validate, explain, critique, refactor), and optional vision AI. Install is simple via npx. Risks exist but are mitigated with backups and dryRun. Suitable for game developers; note the need for backups and vision AI endpoint configuration.
RPG Maker MV Ultimate MCP server lets an AI agent edit a real RPG Maker MV project on disk — database, maps, events, system — through 13 consolidated tools, validated against the actual engine for coherent output. Its headline feature is knowledge-driven map generation: clones hand-authored reference maps from 106 bundled RTP templates and adapts them to your project's tilesets, falling back to procedural generation for themes without a template. It also offers read-only project intelligence (validates references, explains why an event never fires, critiques maps) and optional Vision-AI image analysis.
Tools
query_database
List / get by ID / search any database (actors, classes, skills, items, weapons, armors, enemies, states, troops, tilesets, common events, animations).
create_database_entry
Create entries, with presets: damage_skill, healing_skill, buff_skill, state_skill, boss_enemy, encounter_troop.
update_database_entry
Partial updates (incl. troops & animations); append commands to common events; add enemies to troops.
delete_database_entry
Delete entries incl. troops & animations (with reference-breakage warnings).
query_map
Map tree, full map data, events, single event, lint (validate), offline ASCII render.
generate_map
Knowledge-driven generation: clones a real reference map per theme (or pure procedural / blank / themed / a specific template / batch / duplicate).
edit_map
Fill tile layers, set display names, organize the map tree, connect two maps, set encounters.
manage_map_event
Create (presets: npc, chest, teleport, door, shop, inn, boss, puzzle_switch), update, convert an existing event into a merchant/inn/sign, delete, add commands, bulk-populate.
manage_system
Game title, switch/variable names, starting position; author a plugin (create_plugin), scaffold a new project (scaffold_project), and run the game (playtest) / open it in the editor (open_editor).
analyze_project
Read-only project intelligence — overview, index, validate, graph, usage, explain, ast, plugins, critique, refactor, search.
get_project_context
Project digest, asset index, per-tileset tile IDs, bundled-template catalog.
set_project_path
Switch projects at runtime.
analyze_image
Optional Vision-AI image analysis, plus offline tileset grid measurement and quadrant colors.
Setup
Install via npm: add the server to your MCP client config with the command 'npx -y rpgmaker-mv-mcp' and set the RPGMAKER_PROJECT_PATH environment variable to the absolute path of your RPG Maker MV project. No clone required; the package ships an executable. The server starts even without the path; you can call set_project_path at runtime.
claude_desktop_config.json
{
"mcpServers": {
"rpgmaker-mv": {
"command": "npx",
"args": [
"-y",
"rpgmaker-mv-mcp"
],
"env": {
"RPGMAKER_PROJECT_PATH": "/path/to/your/RPGMakerMV/project"
}
}
}
}
Fit and risk
Not for
- Projects not using RPG Maker MV
- Users expecting real-time synchronization with a visual editor (this edits files directly, no GUI)
- Those who want vision AI capabilities without configuring an external endpoint
Required permissions
- Read and write project files (data/ and js/)
- Run the game (playtest) or open the editor
- Network access (optional, only for vision AI)
Risks and side effects
- Incorrect operations can corrupt project data, but backup mechanisms exist
- Using vision AI sends images to the configured endpoint
- Procedural generation may not match design intent
Troubleshooting
- Ensure RPGMAKER_PROJECT_PATH correctly points to the project folder (containing data and js)
- If vision features don't work, check VISION_API_URL, VISION_API_KEY, and VISION_MODEL settings
- For write operations, check the backup directory .mcp-backups/ if something goes wrong
- Playtest requires locating the engine installation (via install or default Steam path)
Use cases
Generate complete, playable maps (towns, dungeons) from text descriptions.
Create NPCs, shops, teleports, bosses, and other events via natural language.
Analyze project consistency, finding broken references and unreachable maps.
Explain why a certain event (e.g., a door that never opens) never triggers.
Get design reviews of a map: dead space, cluttered areas, event distribution.
Scaffold a new project or author plugins quickly.
Supported clients
Claude DesktopFull support
Claude CodeFull support
opencodeFull support