🎮 RPG Maker MZ MCP Server

完全なRPG Maker MZゲーム開発のためのMCPサーバー

License: MIT Node.js Version TypeScript

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)

📦 利用可能なツール

🎮 プロジェクト管理

ツール	説明
`create_project`	新規プロジェクト作成
`list_projects`	プロジェクト一覧表示
`read_project_info`	プロジェクト情報読み取り
`generate_project_context`	コンテキストドキュメント生成
`analyze_project_structure`	プロジェクト構造分析
`extract_game_design_patterns`	ゲームデザインパターン抽出

🗺️ マップ編集

ツール	説明
`create_map`	新規マップ作成
`list_maps`	マップ一覧表示
`read_map`	マップデータ読み取り
`update_map_tile`	タイル更新

🎭 イベント編集

ツール	説明
`add_event`	イベント追加
`add_event_command`	イベントコマンド追加

対応イベントコマンド例:

101 - テキスト表示
201 - プレイヤー移動
122 - 変数操作
111 - 条件分岐
その他RPG Maker MZ全コマンド対応

📊 データベース編集

ツール	説明
`add_actor`	アクター追加
`add_class`	クラス追加
`add_skill`	スキル追加
`add_item`	アイテム追加
`update_database`	全データベース更新

🎨 AI画像生成

ツール	説明
`generate_asset`	Gemini 2.5 Flashでアセット生成
`generate_asset_batch`	複数アセットのバッチ生成
`describe_asset`	既存アセットのAI分析

🤖 自律的ゲーム作成（NEW!）

ツール	説明
`autonomous_create_game`	コンセプトから完全なRPGを自動生成（8ステップ全自動）

📖 AIシナリオ生成

ツール	説明
`generate_scenario`	Gemini AIで完全なRPGシナリオ生成
`implement_scenario`	生成されたシナリオをプロジェクトに実装
`generate_and_implement_scenario`	シナリオ生成と実装をワンステップで
`generate_scenario_variations`	複数のシナリオバリエーション生成

🔌 プラグイン管理

ツール	説明
`list_plugins`	プラグイン一覧表示

🚀 セットアップ

前提条件

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 build

MCP設定

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"

💡 使用例

基本的なゲーム作成フロー

// 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