Rpgmaker Mv MCP server

RPG Maker MV MCP Server

A Model Context Protocol server that turns AI assistants (Claude Code, Claude Desktop, or any MCP client) into a co-developer for RPG Maker MV projects — with automatic backups of everything it touches.

Ask your assistant things like:

"Create a Fireball skill: magical damage, a.mat 4 - b.mdf 2, 12 MP, fire element."

"Find every event in the game that mentions the mayor."

"Add a guard to the castle gate who says 'Halt! Who goes there?'"

"Rebalance all weapons: +10% attack across the board."

"Validate the project — anything broken?"

Highlights

armors, enemies, troops, states, animations, tilesets, common events) plus System.json, through a compact generic CRUD interface.

• Full database access — all 12 database types (actors, classes, skills, items, weapons,

state skills from just a name and a formula.

• High-level skill builders — create complete, editor-valid damage / healing / buff /

batches, add dialogue with automatic message-box splitting, and consult a built-in event command code reference.

• Maps and events — create maps, create/edit/delete events, insert event commands in

every map, including inside event command lists (find which event shows a line of dialogue or runs a script).

• Search everywhere — substring search across every database, and across every event on

source, all in the editor's own js/plugins.js format.

• Plugin management — enable/disable/configure plugins, scaffold new ones, edit plugin

locations) with stdout/stderr capture, or serve it to a browser via the built-in HTTP server.

• Playtest control — launch the game through NW.js (auto-detected from common install

each session; restorebackup rolls anything back, and validateproject catches broken references before you ship.

• Safety net — every file is snapshotted to .mcp-backups/ before its first modification

Installation

Requires Node.js 18+.

Quick start (npm)

The easiest way for Claude Code or Claude Desktop users:

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

Then configure it (see below). The package is available on npmjs.com and in the MCP Registry.

Configure Claude Code

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

Configure Claude Desktop

Add to claudedesktopconfig.json:

{
  "mcpServers": {
    "rpgmaker-mv": {
      "command": "npx",
      "args": [
        "@xerolo44/rpgmaker-mv-mcp",
        "--project", "/path/to/YourGame"
      ]
    }
  }
}

--project is optional — without it, ask the assistant to call set_project first. The project can also be switched mid-session.

Custom connector / URL-based clients (HTTPS) — experimental

Some clients (e.g. "Add custom connector" UIs) don't spawn a local process — they connect to a URL instead. Run the server in HTTPS mode:

node dist/index.js --http [port]   # default port 3939

This starts a Streamable HTTP MCP endpoint at https://127.0.0.1:/mcp, bound to localhost only (never reachable from the network — every request is checked against the connecting socket's address, not just the bind address). A self-signed TLS certificate for localhost/127.0.0.1 is generated on first run and cached in .certs/ (gitignored) next to the project.

Shortened. The full README is on GitHub.