The RPG Maker MZ MCP Server enables complete RPG Maker MZ game development programmatically and AI-driven, without needing to open the GUI.
Autonomous Game Creation Generate a complete RPG from a single concept in 3–7 minutes via an 8-step automated process (project setup, scenario, battle system, quests, AI assets, balancing, optimization), with configurable length, difficulty, and asset counts.
Project Management Create, list, and read projects; analyze project structure; extract game design patterns; and generate context documentation.
Map Editing Create maps with custom dimensions, list and read existing maps, and update individual tiles programmatically.
Event System Add events to maps and attach event commands (show text, transfer player, control variables, conditional branching, etc.), supporting all RPG Maker MZ event command codes.
Database Management Add and update actors, classes, skills, items, weapons, armors, enemies, and other database entries. Search the database with filters.
AI Asset Generation (Gemini 2.5 Flash) Generate character sprites, face graphics, tilesets, battle backgrounds, enemy graphics, side-view battlers, and pictures — individually or in batches. Can also analyze and describe existing assets.
AI Scenario Generation (Gemini AI) Generate complete RPG scenarios (story, maps, characters, events, items), implement them directly into a project, or generate multiple variations for comparison.
Plugin & Resource Management List project plugins; register and manage reusable resources (templates, assets, scenarios) and prompt templates with variables; execute templated prompts.
Analysis & Optimization Analyze all project assets for usage patterns, detect unused assets, and generate optimization recommendations.
Integrates with Gemini API for AI-powered scenario generation and Gemini 2.5 Flash for automatic game asset generation including
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@RPG Maker MZ MCP Servercreate a fantasy RPG about a dragon hunter in a medieval kingdom"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
🎮 RPG Maker MZ MCP Server
完全なRPG Maker MZゲーム開発のためのMCPサーバー
MCP toolsのみでRPGゲームを完全に作成可能 + AI画像生成対応!
📖 初心者向けガイド | 特徴 • インストール • 使用例 • ツール一覧
🌟 特徴
このMCPサーバーは、RPG Maker MZの完全なゲーム開発環境をプログラマティックに提供します。GUIを開くことなく、コードやAIエージェントを使って本格的なRPGゲームを作成できます。
🎯 主な特徴
🤖 🆕 自律的全自動ゲーム作成: コンセプトを入力するだけで3-7分で完全なRPGを生成!
🚀 完全なプロジェクト作成: ゼロからRPG Maker MZプロジェクトを生成
🗺️ マップエディタ: プログラマティックにマップとタイルを編集
🎭 イベントシステム: 複雑なゲームイベントとストーリーを実装
📊 データベース管理: アクター、スキル、アイテムなど全データ編集
🎨 AI画像生成: Gemini 2.5 Flash (nanobanana) でゲームアセットを自動生成
📖 AIシナリオ生成: Gemini APIで完全なストーリー・マップ・イベントを自動生成
🔧 MCP統合: Model Context Protocolを使った完全なツールチェーン
🤖 自律的全自動ゲーム作成(NEW!)
わずか1行のコマンドで完全なRPGを生成!
npx rpgmaker-mz-mcp auto-create "/games/MyRPG" "fantasy adventure with dragons"または Claude Code で:
"cyberpunk detective story" というコンセプトでRPGを自動生成して自動実行される8ステップ:
✅ プロジェクト作成
✅ コンセプト分析
✅ シナリオ生成(マップ・キャラ・イベント)
✅ バトルシステム(敵・スキル)
✅ クエストシステム
✅ AI画像アセット生成
✅ ステータスバランス調整
✅ プロジェクト最適化
⏱️ 所要時間: 3-7分 → 即プレイ可能!
詳細は AUTONOMOUS_CREATION.md を参照。
🎨 AI画像生成(NEW!)
Gemini 2.5 Flash APIを使用して、RPG Maker MZ用のアセットを自動生成:
キャラクタースプライト (144x192px, 3x4グリッド)
フェイスグラフィック (144x144px, 2x2グリッド)
タイルセット (768x768px)
バトルバック (1000x740px)
エネミーグラフィック (816x624px)
サイドビューバトラー (576x384px, 9x6グリッド)
ピクチャー (816x624px)
📦 利用可能なツール
🎮 プロジェクト管理
ツール | 説明 |
| 新規プロジェクト作成 |
| プロジェクト一覧表示 |
| プロジェクト情報読み取り |
| コンテキストドキュメント生成 |
| プロジェクト構造分析 |
| ゲームデザインパターン抽出 |
🗺️ マップ編集
ツール | 説明 |
| 新規マップ作成 |
| マップ一覧表示 |
| マップデータ読み取り |
| タイル更新 |
🎭 イベント編集
ツール | 説明 |
| イベント追加 |
| イベントコマンド追加 |
対応イベントコマンド例:
101- テキスト表示201- プレイヤー移動122- 変数操作111- 条件分岐その他RPG Maker MZ全コマンド対応
📊 データベース編集
ツール | 説明 |
| アクター追加 |
| クラス追加 |
| スキル追加 |
| アイテム追加 |
| 全データベース更新 |
🎨 AI画像生成
ツール | 説明 |
| Gemini 2.5 Flashでアセット生成 |
| 複数アセットのバッチ生成 |
| 既存アセットのAI分析 |
🤖 自律的ゲーム作成(NEW!)
ツール | 説明 |
| コンセプトから完全なRPGを自動生成(8ステップ全自動) |
📖 AIシナリオ生成
ツール | 説明 |
| Gemini AIで完全なRPGシナリオ生成 |
| 生成されたシナリオをプロジェクトに実装 |
| シナリオ生成と実装をワンステップで |
| 複数のシナリオバリエーション生成 |
🔌 プラグイン管理
ツール | 説明 |
| プラグイン一覧表示 |
🚀 セットアップ
前提条件
Node.js 18以上
npm または yarn
Gemini API Key (AI画像生成を使用する場合)
インストール
# リポジトリをクローン
git clone https://github.com/ShunsukeHayashi/rpgmaker-mz-mcp.git
cd rpgmaker-mz-mcp
# 依存関係をインストール
npm install
# ビルド
npm run buildMCP設定
Claude Desktop または他のMCPクライアントの設定ファイルに追加:
{
"mcpServers": {
"rpgmaker-mz": {
"command": "node",
"args": ["/path/to/rpgmaker-mz-mcp/dist/index.js"],
"env": {
"GEMINI_API_KEY": "your-gemini-api-key-here"
}
}
}
}環境変数
AI画像生成機能を使用する場合、以下の環境変数を設定:
export GEMINI_API_KEY="your-api-key"
# RPG Maker MZ バージョン設定(オプション)
# デフォルト: game.rmmzproject(MZ 1.9以降)
# 旧バージョン(1.8以前)を使用する場合:
export RPGMAKER_USE_OLD_EXTENSION=true # → Game.rpgproject注意: RPG Maker MZ 1.9以降では .rmmzproject 拡張子が標準です。1.8以前の環境で使用する場合のみ RPGMAKER_USE_OLD_EXTENSION=true を設定してください。
💡 使用例
基本的なゲーム作成フロー
// 1️⃣ プロジェクト作成
create_project({
project_path: "/path/to/MyFantasyRPG",
game_title: "Fantasy Adventure"
})
// 2️⃣ マップ作成
create_map({
project_path: "/path/to/MyFantasyRPG",
map_id: 2,
name: "Town Square",
width: 25,
height: 20
})
// 3️⃣ NPCイベント追加
add_event({
project_path: "/path/to/MyFantasyRPG",
map_id: 2,
event_id: 1,
name: "Town Elder",
x: 12,
y: 10
})
// 4️⃣ 会話イベント追加
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_actor({
project_path: "/path/to/MyFantasyRPG",
id: 1,
name: "Hero"
})
add_class({
project_path: "/path/to/MyFantasyRPG",
id: 1,
name: "Warrior"
})🎨 AI画像生成の使用例
// キャラクタースプライト生成
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_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"
})
// バッチ生成
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"
}
]
})
// 既存アセット分析
describe_asset({
project_path: "/path/to/MyFantasyRPG",
asset_type: "character",
filename: "Knight.png"
})
// → "This character sprite shows a knight in silver armor..."📖 AIシナリオ自動生成(超強力!)
// ワンコマンドで完全なRPGを生成!
generate_and_implement_scenario({
project_path: "/path/to/MyFantasyRPG",
theme: "medieval fantasy adventure with dragons",
style: "epic and heroic",
length: "medium"
})
// 生成される内容:
// - ストーリーと世界観
// - マップ(町、ダンジョン、フィールドなど)
// - キャラクター(主人公、仲間、NPC)
// - イベント(会話、クエスト、バトル)
// - アイテムとスキル
// すべて自動で実装されます!
// 複数バリエーション生成して比較
generate_scenario_variations({
project_path: "/path/to/MyFantasyRPG",
theme: "cyberpunk detective story",
style: "noir and mysterious",
length: "short",
count: 3
})
// → 3つの異なるストーリーを生成して最適なものを選択📊 プロジェクト分析
// プロジェクト構造分析
analyze_project_structure({
project_path: "/path/to/MyFantasyRPG"
})
// コンテキスト生成
generate_project_context({
project_path: "/path/to/MyFantasyRPG",
include_maps: true,
include_events: true,
include_plugins: true
})
// デザインパターン抽出
extract_game_design_patterns({
project_path: "/path/to/MyFantasyRPG"
})🎯 ユースケース
1. 🤖 完全自動ゲーム生成
"ファンタジーRPGを作って" → AIが自動でストーリー、マップ、キャラ、イベントを生成!2. 🎨 AI駆動の開発ワークフロー
シナリオ生成 → アセット生成 → 実装 → 完成
全てAIがサポート3. 📚 ゲームプロトタイプ大量生成
複数のストーリーコンセプトを試して、最適なものを選択4. 🔄 プログラマティックなゲーム開発
Pythonスクリプトやワークフローツールからゲームを生成5. 🧪 テストデータ自動生成
ゲームエンジンのテスト用プロジェクトを即座に作成6. 🎓 教育・学習
RPG Maker MZの学習用サンプルを自動生成📊 開発状況
機能 | 状態 |
✅ プロジェクト作成・管理 | 完了 |
✅ マップ作成・編集 | 完了 |
✅ イベント作成・編集 | 完了 |
✅ データベース編集 | 完了 |
✅ AI画像生成 (Gemini 2.5 Flash) | 完了 |
✅ AIシナリオ自動生成 | NEW! |
✅ コンテキストエンジニアリング | 完了 |
✅ 完全なゲーム作成ワークフロー | 完了 |
🌟 特筆機能
🚀 ワンコマンドRPG生成
# たった1つのコマンドで完全なRPGゲームが生成されます
generate_and_implement_scenario({
theme: "your game idea",
style: "your preferred style",
length: "short"
})
# → 数分でプレイ可能なRPGが完成!🎨 完全AI駆動開発
シナリオ: Gemini AIが自動生成
アセット: Gemini 2.5 Flashが画像生成
実装: MCPツールが自動実装
結果: 完全に動作するRPG Maker MZプロジェクト
🤝 コントリビューション
Pull Requestsを歓迎します!
📄 ライセンス
MIT License
🔗 リンク
🎮 MCP toolsのみでRPG Maker MZゲームを完全に作成可能! 🎮
Made with ❤️ by ShunsukeHayashi