Skip to content
MCP server

Rpgmaker Mv MCP

Let an AI assistant read, edit, paint and playtest RPG Maker MV projects, with backups

Runs locallyStatus and history
Install
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-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "rpgmaker-mv-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@xerolo44/rpgmaker-mv-mcp"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "rpgmaker-mv-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@xerolo44/rpgmaker-mv-mcp"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

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.

How AIPoweredBot checks servers