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.

Related MCP server: RPG Maker MZ MCP Server

🛠️ Installation

1. Clone the repository:

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

2. Install dependencies:

   npm install

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