Rpgmaker Mz MCP

🚀 RPG Maker MZ MCP Server

A MCP server for complete RPG Maker MZ game development

✨ Features

This MCP server programmatically provides a complete game development environment for RPG Maker MZ. You can create full-fledged RPG games using code and AI agents without opening the GUI.

🎯 Key Features

• 🤖 🆕 Autonomous Fully Automatic Game Creation: Generate a complete RPG in 3 - 7 minutes just by entering a concept!
• 🚀 Complete Project Creation: Generate an RPG Maker MZ project from scratch.
• 🗺️ Map Editor: Programmatically edit maps and tiles.
• 🎭 Event System: Implement complex game events and stories.
• 📊 Database Management: Edit all data such as actors, skills, and items.
• 🎨 AI Image Generation: Automatically generate game assets using Gemini 2.5 Flash (nanobanana).
• 📖 AI Scenario Generation: Automatically generate complete stories, maps, and events using the Gemini API.
• 🔧 MCP Integration: A complete toolchain using the Model Context Protocol.

🤖 Autonomous Fully Automatic Game Creation (NEW!)

Generate a complete RPG with just one line of command!

npx rpgmaker-mz-mcp auto-create "/games/MyRPG" "fantasy adventure with dragons"

Or with Claude Code:

Automatically generate an RPG with the concept of "cyberpunk detective story"

Eight automatically executed steps:

1. ✅ Project Creation
2. ✅ Concept Analysis
3. ✅ Scenario Generation (Maps, Characters, Events)
4. ✅ Battle System (Enemies, Skills)
5. ✅ Quest System
6. ✅ AI Image Asset Generation
7. ✅ Status Balance Adjustment
8. ✅ Project Optimization

⏱️ Time Required: 3 - 7 minutes → Ready to play immediately!

Refer to AUTONOMOUS_CREATION.md for more details.

🎨 AI Image Generation (NEW!)

Use the Gemini 2.5 Flash API to automatically generate assets for RPG Maker MZ:

• Character Sprites (144x192px, 3x4 grid)
• Face Graphics (144x144px, 2x2 grid)
• Tile Sets (768x768px)
• Battle Backs (1000x740px)
• Enemy Graphics (816x624px)
• Side-View Battlers (576x384px, 9x6 grid)
• Pictures (816x624px)

📦 Available Tools

🎮 Project Management

🗺️ Map Editing

🎭 Event Editing

Examples of supported event commands:

• 101 - Show Text
• 201 - Player Movement
• 122 - Variable Manipulation
• 111 - Conditional Branch
• Supports all other RPG Maker MZ commands

📊 Database Editing

🎨 AI Image Generation

🤖 Autonomous Game Creation (NEW!)

📖 AI Scenario Generation

🔌 Plugin Management

🚀 Quick Start

Prerequisites

• Node.js version 18 or higher
• npm or yarn
• Gemini API Key (if using AI image generation)

Installation

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

# Install dependencies
npm install

# Build
npm run build

MCP Configuration

Add the following to the configuration file of Claude Desktop or other MCP clients:

{
  "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 using the AI image generation feature, set the following environment variable:

export GEMINI_API_KEY="your-api-key"

💻 Usage Examples

Basic Game Creation Flow

// 1️⃣ Create a project
create_project({
  project_path: "/path/to/MyFantasyRPG",
  game_title: "Fantasy Adventure"
})

// 2️⃣ Create a map
create_map({
  project_path: "/path/to/MyFantasyRPG",
  map_id: 2,
  name: "Town Square",
  width: 25,
  height: 20
})

// 3️⃣ Add an NPC event
add_event({
  project_path: "/path/to/MyFantasyRPG",
  map_id: 2,
  event_id: 1,
  name: "Town Elder",
  x: 12,
  y: 10
})

// 4️⃣ Add a conversation event
add_event_command({
  project_path: "/path/to/MyFantasyRPG",
  map_id: 2,
  event_id: 1,
  page_index: 0,
  code: 101,  // Show Text
  parameters: ["", 0, 0, 2]
})

add_event_command({
  project_path: "/path/to/MyFantasyRPG",
  map_id: 2,
  event_id: 1,
  page_index: 0,
  code: 401,  // Text continuation
  parameters: ["Welcome to our town, traveler!"]
})

// 5️⃣ Add a player character
add_actor({
  project_path: "/path/to/MyFantasyRPG",
  id: 1,
  name: "Hero"
})

add_class({
  project_path: "/path/to/MyFantasyRPG",
  id: 1,
  name: "Warrior"
})

🎨 Usage Example of AI Image Generation

// Generate a character sprite
generate_asset({
  project_path: "/path/to/MyFantasyRPG",
  asset_type: "character",
  prompt: "A brave knight with silver armor and red cape, pixel art style, walking animation sprite sheet",
  filename: "Knight.png"
})

// Generate a face graphic
generate_asset({
  project_path: "/path/to/MyFantasyRPG",
  asset_type: "face",
  prompt: "Female mage with blue robes and long purple hair, multiple expressions (normal, happy, sad, angry)",
  filename: "Mage_Face.png"
})

// Batch generation
generate_asset_batch({
  requests: [
    {
      project_path: "/path/to/MyFantasyRPG",
      asset_type: "enemy",
      prompt: "Fire dragon boss, menacing pose",
      filename: "Dragon.png"
    },
    {
      project_path: "/path/to/MyFantasyRPG",
      asset_type: "enemy",
      prompt: "Goblin warrior with wooden club",
      filename: "Goblin.png"
    }
  ]
})

// Analyze an existing asset
describe_asset({
  project_path: "/path/to/MyFantasyRPG",
  asset_type: "character",
  filename: "Knight.png"
})
// → "This character sprite shows a knight in silver armor..."

📖 Automatic AI Scenario Generation (Super Powerful!)

// Generate a complete RPG with a single command!
generate_and_implement_scenario({
  project_path: "/path/to/MyFantasyRPG",
  theme: "medieval fantasy adventure with dragons",
  style: "epic and heroic",
  length: "medium"
})

// Generated content:
// - Story and worldview
// - Maps (towns, dungeons, fields, etc.)
// - Characters (protagonists, companions, NPCs)
// - Events (conversations, quests, battles)
// - Items and skills
// All are automatically implemented!

// Generate and compare multiple variations
generate_scenario_variations({
  project_path: "/path/to/MyFantasyRPG",
  theme: "cyberpunk detective story",
  style: "noir and mysterious",
  length: "short",
  count: 3
})
// → Generate 3 different stories and select the best one

📊 Project Analysis

// Analyze project structure
analyze_project_structure({
  project_path: "/path/to/MyFantasyRPG"
})

// Generate context
generate_project_context({
  project_path: "/path/to/MyFantasyRPG",
  include_maps: true,
  include_events: true,
  include_plugins: true
})

// Extract design patterns
extract_game_design_patterns({
  project_path: "/path/to/MyFantasyRPG"
})

🎯 Use Cases

1. 🤖 Fully Automatic Game Generation

"Create a fantasy RPG" → AI automatically generates stories, maps, characters, and events!

2. 🎨 AI-Driven Development Workflow

Scenario Generation → Asset Generation → Implementation → Completion
All supported by AI

3. 📚 Mass Generation of Game Prototypes

Try multiple story concepts and select the best one

4. 🔄 Programmatic Game Development

Generate games from Python scripts or workflow tools

5. 🧪 Automatic Test Data Generation

Immediately create test projects for the game engine

6. 🎓 Education and Learning

Automatically generate sample projects for learning RPG Maker MZ

📊 Development Status

🌟 Notable Features

🚀 One-Command RPG Generation

# Generate a complete RPG game with just one command
generate_and_implement_scenario({
  theme: "your game idea",
  style: "your preferred style",
  length: "short"
})
# → A playable RPG is completed in a few minutes!

🎨 Fully AI-Driven Development

• Scenario: Automatically generated by Gemini AI
• Assets: Images generated by Gemini 2.5 Flash
• Implementation: Automatically implemented by MCP tools
• Result: A fully functional RPG Maker MZ project

🤝 Contribution

Pull Requests are welcome!

📄 License

MIT License

🔗 Links

• Official RPG Maker MZ
• Model Context Protocol
• Gemini API