RPG Maker MZ MCP Server

How to use

You interact with the MCP server through a client that connects to the MCP endpoint you configure. Your workflow centers on sending commands that create projects, design maps and events, edit data, generate assets, and assemble complete RPG experiences. You can start from a concept, trigger autonomous creation, and then refine or re-run variations as needed. Use the available tools to script your game pipeline and integrate AI-generated content directly into your RPG Maker MZ project.

Key usage patterns include creating a new game project, building maps, adding events and NPCs, injecting dialogue, generating actors and items, producing AI-assisted art, and automating scenario generation. You can also analyze project structure, extract design patterns, and generate context documentation to keep your workflow organized. All steps are designed to work programmatically, allowing you to drive development from scripts or MCP-enabled clients.

How to install

Prerequisites you need before running the MCP server are Node.js version 18 or higher and a package manager such as npm or yarn. If you plan to generate AI images, you also need a Gemini API key.

Install and build the MCP server with these commands in sequence.

# Clone the project repository
git clone https://github.com/ShunsukeHayashi/rpgmaker-mz-mcp.git
cd rpgmaker-mz-mcp

# Install dependencies
npm install

# Build the project
npm run build

Configuration and running the MCP server

Configure your MCP client to connect to the server using a local stdio setup. The following configuration runs the server locally via Node and points to the built entry script. If you plan to use AI image generation, include your Gemini API key in the environment.

{
  "mcpServers": {
    "rpgmaker-mz": {
      "command": "node",
      "args": ["/path/to/rpgmaker-mz-mcp/dist/index.js"],
      "env": {
        "GEMINI_API_KEY": "your-gemini-api-key-here"
      }
    }
  }
}

Environment variables

If you enable AI image generation, you must provide the Gemini API key as an environment variable. This key is used to generate character sprites, face graphics, tiles, and other assets.

export GEMINI_API_KEY="your-api-key"

create_project

Create a new RPG Maker MZ project at a specified path with a given title.

list_projects

List all MCP-managed projects.

read_project_info

Read detailed information about a specific project.

generate_project_context

Create a contextual document describing a project, including maps, events, and plugins.

analyze_project_structure

Analyze the project layout to aid planning and refactoring.

extract_game_design_patterns

Extract common design patterns from the project for reuse.

create_map

Create a new map within a project with specified dimensions and name.

list_maps

List all maps in a project.

read_map

Read data for a specific map.

update_map_tile

Update a tile on a map.

add_event

Add a new event to a map.

add_event_command

Add a command to an existing event.

add_actor

Add a new actor to the database.

add_class

Add a new class for actors.

add_skill

Add a skill to the game database.

add_item

Add an item to the game database.

update_database

Update all data in the game database.

generate_asset

Generate a single AI-based asset using Gemini 2.5 Flash.

generate_asset_batch

Generate multiple assets in a batch process.

describe_asset

Analyze an existing asset and describe its features.

autonomous_create_game

Automatically generate a complete RPG from a concept (8 steps end-to-end).

generate_scenario

Generate a full RPG scenario using Gemini AI.

implement_scenario

Implement a generated scenario into the project.

generate_and_implement_scenario

Generate a scenario and implement it in one step.

generate_scenario_variations

Create multiple scenario variations for comparison.

list_plugins

List available plugins for the project.