# Rpgmaker Mv MCP

> Rpgmaker Mv MCP is an open-source MCP server for games and play. Let an AI assistant read, edit, paint and playtest RPG Maker MV projects, with backups. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, Windows, macOS, Linux
- **Repository:** https://github.com/xerolo44/rpg-maker-mv-mcp
- **MCP Registry name:** io.github.Xerolo44/rpgmaker-mv-mcp
- **Categories:** [games and play](https://ai-powered.com/categories/games-and-play), [developer tools](https://ai-powered.com/categories/developer-tools)
- **Listing updated:** 2026-11-18

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add rpgmaker-mv-mcp -- npx -y @xerolo44/rpgmaker-mv-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "rpgmaker-mv-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@xerolo44/rpgmaker-mv-mcp"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "rpgmaker-mv-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@xerolo44/rpgmaker-mv-mcp"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "rpgmaker-mv-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@xerolo44/rpgmaker-mv-mcp"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "rpgmaker-mv-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@xerolo44/rpgmaker-mv-mcp"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "rpgmaker-mv-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@xerolo44/rpgmaker-mv-mcp"
      ]
    }
  }
}
```

## Tools

- `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.

## 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.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Context7](https://ai-powered.com/mcp/context7): Context7 is a freemium MCP server for developer tools.
- [Chrome DevTools MCP](https://ai-powered.com/mcp/chrome-devtools-mcp-2): Chrome DevTools MCP is an open-source MCP server for browser automation.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [awesome-mcp-servers](https://ai-powered.com/mcp/awesome-mcp-servers-2): awesome-mcp-servers is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.

---
Source: https://ai-powered.com/mcp/rpgmaker-mv-mcp
