Log inSubmit server
Rpgmaker Mv MCP logo

Rpgmaker Mv MCP

Read, edit, analyze, and playtest RPG Maker MV projects through MCP tools.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Rpgmaker Mv MCP

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "rpgmaker-mv-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@xerolo44/rpgmaker-mv-mcp"
      ]
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Install not yet sandbox-tested— the server itself is confirmed live (we called its tools/list endpoint). The stdio install command is a separate, ongoing check.

Overview

The rpgmaker-mv-mcp MCP server connects AI assistants to RPG Maker MV project folders for database, map, event, plugin, and playtest operations. It reads and writes the project’s JSON and JavaScript files through MCP tools, with project selection handled by `set_project` or the `--project` option. Use it to automate game-data edits, author events and dialogue, manage plugins, inspect project structure, and launch browser or NW.js playtests. Node.js 18 or newer is required, with stdio configuration available for Claude Code and Claude Desktop.

Use cases

  • Create and rebalance RPG Maker MV database records
  • Author maps, events, dialogue, and game-flow commands
  • Manage plugin files and plugin configuration
  • Launch and inspect browser or NW.js playtests

Key features

  • Database and System.json CRUD
  • Map, event, dialogue, and plugin editing
  • Search, validation, linting, and analysis tools
  • Asset and localization workflows
  • Browser and NW.js playtest control

Tools41

What Rpgmaker Mv MCP lets your agent do. Expand a tool for its parameters.

Verified live~6.3k tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 1d ago

Recent health check succeeded.

20/21 checks healthy over the last 90d

What it can do

From the 41 tools this server returned when we ran it.

Can delete or modify data · 2Makes network requests · 4Read-only tools · 39
Network at startup3 connections
Files written at startupNone
Install scriptsNone
npm provenanceNot published
Package age89 days
Maintainers1

Observed 2026-10-16 in an isolated sandbox. A description of reach, not a security audit.

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 7d ago via OSV.dev · @xerolo44/rpgmaker-mv-mcp (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars10Stargazers on the source repository.
npm downloads1.3kPackage downloads in the last 30 days.
Last commit14d agoMost recent push to the default branch.
Tools exposed41Callable tools this server registers over MCP.
Directory activity10 viewsConfig copies, upvotes, and views on AllMCPs.

How Rpgmaker Mv MCP works

What rpgmaker-mv-mcp does

rpgmaker-mv-mcp gives MCP clients structured access to RPG Maker MV projects. It can inspect project metadata, database records, system settings, maps, events, plugins, and registered assets. Editing tools cover record creation and updates, event authoring, dialogue insertion, map properties, plugin source, and project system data.

The server also includes higher-level workflows for common game-development tasks. These include skill creation, bulk database changes, stat-curve generation, localization import and export, map generation, reusable map stamps, asset inspection, event templates, dialogue trees, reference checks, progression analysis, event linting, and battle simulation.

How it works

A project is selected with set_project, which expects the folder containing Game.rpgproject and data/, unless the server starts with --project. Database records are addressed by type and numeric ID. Existing records can be shallow-merged or fully replaced, while new records are appended and receive an ID based on their array position.

Maps and events are edited through dedicated tools. Events can be created, replaced, deleted, or modified by inserting commands into a page. add_dialogue builds Show Text commands and splits longer dialogue into additional message boxes. The event command reference provides the codes and parameters needed for lower-level event edits.

Before modifying files, the server snapshots each file touched during a session in .mcp-backups/. Project validation, backup restoration, dry-run diffs, and changesets provide additional ways to review or undo edits.

Setup and configuration

Install the package globally with npm:

Terminal
npm install -g @xerolo44/rpgmaker-mv-mcp

The package requires Node.js 18 or newer. For Claude Code, register it with the project path:

Terminal
claude mcp add rpgmaker-mv -- npx @xerolo44/rpgmaker-mv-mcp --project "/path/to/YourGame"

Claude Desktop uses the same command and arguments in its claude_desktop_config.json MCP server entry. The --project argument is optional; without it, call set_project before using project tools.

An experimental HTTPS mode is available with node dist/index.js --http [port]. It exposes a localhost-only Streamable HTTP endpoint at /mcp, uses a cached self-signed certificate, and requires the process to remain running. Client support for self-signed localhost certificates varies, so stdio is the documented choice for Claude Code and Claude Desktop.

Tools and capabilities

  • Inspect project information, database records, system settings, maps, events, and plugins.
  • Create, update, and delete database entries, maps, events, dialogue, switches, variables, and map properties.
  • Add, configure, remove, read, write, and scaffold RPG Maker MV plugins.
  • Search database content and event command lists across maps.
  • Build skills, dialogue trees, event templates, map connections, generated maps, and reusable map stamps.
  • Import, export, preview, and audit assets and localized game text.
  • Validate references, lint events, simulate events and battles, analyze progression, and produce balance reports.
  • Start NW.js or browser playtests and inspect playtest status.

Limitations and notes

Tile editing is not supported by the basic map update tool, although the broader toolset includes map-painting and generation workflows. get_map omits tile data unless explicitly requested because the data is large. Deleting an event leaves its array slot as null so other event IDs remain unchanged.

NW.js playtests require a runtime path when automatic discovery is not suitable. Browser playtests return a local URL to open. HTTPS connector use may fail when a client rejects the generated self-signed certificate. Plugin parameter values are handled as strings, matching RPG Maker MV’s plugin format.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Rpgmaker Mv MCP

rpgmaker-mv-mcp is an MCP server that connects AI assistants to RPG Maker MV project folders and exposes tools for reading and editing databases, maps, events, plugins, and system settings. It also supports dialogue authoring, project analysis, asset workflows, backups, and browser or NW.js playtests.

Install it with `npm install -g @xerolo44/rpgmaker-mv-mcp` on Node.js 18 or newer. Register the command with Claude Code or Claude Desktop, passing `--project` and the path to the RPG Maker MV project.

Pass the project folder with `--project`, or call `set_project` before other project tools. The folder must contain `Game.rpgproject` and a `data/` directory, and the selected project can be switched during a session.

Yes. Claude Desktop can run it through a local stdio MCP configuration using `npx @xerolo44/rpgmaker-mv-mcp` and the optional `--project` argument.

Yes. `playtest_start` can launch the project through an NW.js runtime or serve it through a local browser HTTP server, while `playtest_status` reports the active mode and URL or process ID.

Related MCP servers

All in Gaming All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewRpgmaker Mv MCP AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/rpgmaker-mv-mcp?style=directory)](https://allmcps.com/mcp/rpgmaker-mv-mcp)
HTML Embed
<a href="https://allmcps.com/mcp/rpgmaker-mv-mcp"><img src="https://allmcps.com/api/badge/rpgmaker-mv-mcp?style=directory" alt="Rpgmaker Mv MCP on AllMCPs" /></a>