Rpgmaker Mv MCP
Let an AI assistant read, edit, paint and playtest RPG Maker MV projects, with backups
- Pricing
- Open source
- Platforms
- CLI, Windows, macOS
- Runs
- Locally
- Version
- 0.5.1
- Listing updated
- today
Similar MCP servers
About Rpgmaker Mv MCP
Rpgmaker Mv MCP is an open-source MCP server for games and play. It runs locally on your machine and is started by your AI client.
The server works directly on an RPG Maker MV project folder, so an assistant can create a skill from a name and a damage formula, add a guard NPC to a castle gate, find every event that mentions the mayor, or rebalance all weapons by a percentage. It covers all 12 database types plus System.json through a generic create, read, update and delete interface, and can create maps, edit events and insert event commands in batches.
Map tools paint tiles with autotile edges computed as the editor does, and render_map_image draws a map to a PNG with real tileset graphics, event sprites and markers so the assistant can see its work. Other tools generate seeded dungeons, compute balance reports, simulate battles with the game's own formulas, export and import text for translation, and manage plugins. A playtest can launch through NW.js or be served to a browser.
Every file is snapshotted to .mcp-backups before its first change in a session, and changesets let you stage, commit and undo a batch of edits. It needs Node.js 18 or newer and runs over stdio, with an experimental local HTTPS mode.
Install
Run in a terminal
claude mcp add rpgmaker-mv-mcp -- npx -y @xerolo44/rpgmaker-mv-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"rpgmaker-mv-mcp": {
"command": "npx",
"args": [
"-y",
"@xerolo44/rpgmaker-mv-mcp"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"rpgmaker-mv-mcp": {
"command": "npx",
"args": [
"-y",
"@xerolo44/rpgmaker-mv-mcp"
]
}
}
}Add to .vscode/mcp.json
{
"servers": {
"rpgmaker-mv-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@xerolo44/rpgmaker-mv-mcp"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"rpgmaker-mv-mcp": {
"command": "npx",
"args": [
"-y",
"@xerolo44/rpgmaker-mv-mcp"
]
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"rpgmaker-mv-mcp": {
"command": "npx",
"args": [
"-y",
"@xerolo44/rpgmaker-mv-mcp"
]
}
}
}Using several servers? Build one config file with the MCP config generator.
Tools this server provides (28)
Taken from the project documentation; the running server may differ.
- set_project
- Choose the project folder.
- render_map
- Show a map as text.
- render_map_image
- Render a map to PNG with tileset graphics.
- connect_maps
- Place transfer doors between two maps.
- list_map_connections
- Show the map graph and broken doors.
- bulk_update_records
- Bulk edit records with a dry-run diff.
- generate_param_curve
- Generate stat curves.
- generate_enemy_scaling
- Generate enemy scaling.
- balance_report
- Report on class curves and enemy threat.
- simulate_battle
- Monte-Carlo battle simulation.
- export_texts
- Export game text to CSV or JSON.
- import_texts
- Import translated text.
- build_dialogue_tree
- Compile dialogue and choices into event commands.
- create_event_from_template
- Create chests, doors, inns, shops and NPCs.
- import_asset
- Copy an image or sound into the project.
- list_assets
- List assets and their uses.
- preview_asset
- Preview an image.
- generate_map
- Generate seeded dungeons and caves.
- capture_stamp
- Capture a piece of map.
- place_stamp
- Place a captured stamp.
- audit_assets
- Audit project assets.
- lint_events
- Lint events.
- simulate_event
- Simulate an event.
- find_usages
- Find where an id is used.
- check_references
- Find references to missing records.
- analyze_progression
- Analyse reachable maps and events.
- restore_backup
- Roll back to a backup.
- validate_project
- Catch broken references.
What it does
- Full database editing
- CRUD over all 12 RPG Maker database types and System.json.
- Map painting and rendering
- Paints tiles and renders maps to PNG with real tileset art.
- Event authoring
- Builds dialogue trees and events such as shops, chests and inns.
- Balance and simulation
- Reports on class curves and simulates battles with game formulas.
- Localization
- Exports and imports all game text as CSV or JSON.
- Backups and changesets
- Snapshots files and supports undoable batches of edits.
Good for
- Create skills, items and enemies from a short description
- Build and connect maps with doors between them
- Check a project for broken references before release
- Prepare game text for translation
Pricing
Open source
Rpgmaker Mv MCP FAQ
How many tools does it have?
The README refers to a tool reference of 78 tools.
Is my project protected from bad edits?
Files are backed up to .mcp-backups before first modification each session, and restore_backup rolls them back.
What Node version is needed?
Node.js 18 or newer.
Can it launch the game?
Yes, through NW.js or a built-in HTTP server for browser play.
Is Rpgmaker Mv MCP free?
Yes. Rpgmaker Mv MCP is open source, so you can use and self-host it for free.
How do I add Rpgmaker Mv MCP to Claude Code?
Run this command in your terminal: claude mcp add rpgmaker-mv-mcp -- npx -y @xerolo44/rpgmaker-mv-mcp
What are the best alternatives to Rpgmaker Mv MCP?
The closest alternatives to Rpgmaker Mv MCP are REA, Context7, Chrome DevTools MCP, Codebase Memory and GitHub.
Where this comes from
- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.


