RPG Maker MZ MCP Server 🎮✨

A powerful Model Context Protocol (MCP) server that allows AI agents (like Claude, Gemini, or Copilot) to directly manipulate RPG Maker MZ projects.

With this tool, you can ask your AI to "Create a fire sword", "Make a potion that regenerates mana", or "Generate a new map", and it will modify the game files directly!

🚀 Features

📦 Database Management (Full CRUD)

Create, Read, and Update almost any database asset:

Items: Create potions, keys, and hidden items. Support for HP/MP recovery and state application.
Weapons & Armors: Create equipment with stats, prices, and elemental effects.
Enemies: Define stats (HP/MP/ATK...), drops, and rewards (EXP/Gold).
States: Create status effects (e.g., Poison, Regen, Stun) with traits.
Actors & Classes: Create new heroes and classes with level curves and traits.
Skills: Define magic and special attacks.

🗺️ Map & World

Create Maps: Generate new map files (MapXXX.json) with metadata (size, tileset, BGM).
List Maps: See all maps in your project hierarchy.

🧩 Plugin & Resources

Plugin Installer: Automatically creates .js files in js/plugins and registers them in plugins.js.
Resource Scanner: List available graphics (img/), audio (audio/), and DLC packages.

🛡️ Safety First

Atomic Writes: Uses a SafeWriter to prevent data corruption.
Editor Sync: Automatically updates System.json version ID, forcing the RPG Maker MZ editor to reload data and preventing conflicts.

🛠️ Installation

Clone the repository:

git clone https://github.com/devmagary/MCP-Maker.git
cd MCP-Maker

Install dependencies:
```
npm install
```
Build the project:
```
npm run build
```

⚙️ Configuration

You need to tell the MCP client where your RPG Maker MZ project and engine are located.

Environment Variables

RPGMAKER_PROJECT_PATH: Full path to your game project (where game.rmmzproject is).
RPGMAKER_ENGINE_PATH: Full path to RPG Maker MZ installation (usually Steam folder).

configuration Examples

VS Code (Claude Dev / Copilot)

Add to your settings or MCP config:

{
  "mcpServers": {
    "rpgmaker-mz": {
      "command": "node",
      "args": ["C:/path/to/MCP-Maker/dist/index.js"],
      "env": {
        "RPGMAKER_PROJECT_PATH": "C:/Users/You/Documents/RMMZ/MyGame",
        "RPGMAKER_ENGINE_PATH": "C:/Program Files (x86)/Steam/steamapps/common/RPG Maker MZ"
      }
    }
  }
}

Claude Desktop

Edit %APPDATA%\Claude\claude_desktop_config.json:

{
  "mcpServers": {
    "rpgmaker-mz": {
      "command": "node",
      "args": ["C:\\path\\to\\MCP-Maker\\dist\\index.js"],
      "env": {
        "RPGMAKER_PROJECT_PATH": "C:\\Users\\You\\Documents\\RMMZ\\MyGame",
        "RPGMAKER_ENGINE_PATH": "C:\\Program Files (x86)\\Steam\\steamapps\\common\\RPG Maker MZ"
      }
    }
  }
}

💻 Tech Stack

TypeScript: Strictly typed for robustness.
Zod: Runtime schema validation for all tool inputs.
MCP SDK: Official Model Context Protocol SDK.
Node.js: Runtime environment.

🤝 Contributing

Feel free to open issues or submit PRs if you want to add more features (e.g., Event creation support)!

Created with ❤️ by DevMagary & Antigravity.