Skip to main content
Glama

Built by 合同会社みやび

🎮 RPG Maker MZ MCP Server

日本語 | English | 中文

完全な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ステップ:

  1. ✅ プロジェクト作成

  2. ✅ コンセプト分析

  3. ✅ シナリオ生成(マップ・キャラ・イベント)

  4. ✅ バトルシステム(敵・スキル)

  5. ✅ クエストシステム

  6. ✅ AI画像アセット生成

  7. ✅ ステータスバランス調整

  8. ✅ プロジェクト最適化

⏱️ 所要時間: 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"

# 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

Related MCP Connectors

  • Your memory, everywhere AI goes. Build knowledge once, access it via MCP anywhere.

  • Generate, edit, and deploy immersive 3D/WebGL web projects from any MCP assistant.

  • OCR, transcription, file extraction, and image generation for AI agents via MCP.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/ShunsukeHayashi/rpgmaker-mz-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server