🎮 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

Deploy Server

HTTP connection URL

security - not tested

license - not found

quality - not tested

How are these scores calculated?

local-only server

The server can only run on the client's local machine because it depends on local resources.

Tools

View all tools

Enables complete RPG Maker MZ game development through MCP tools, including autonomous game creation from concepts, AI-generated assets using Gemini 2.5 Flash, and programmatic control over maps, events, characters, and databases. Supports full game creation workflow from a single command with automatic story, asset, and implementation generation.