Rpgmaker Mz MCP

🚀 🎮 RPG Maker MZ MCP Server

這是一款專為RPG Maker MZ遊戲開發打造的MCP服務器，藉助它，無需打開GUI，僅通過代碼或AI代理，就能創建出專業的RPG遊戲。同時，它還支持AI圖像生成，為遊戲開發增添更多便利。

🚀 快速開始

前提條件

• 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"

✨ 主要特性

此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實現完整的工具鏈。

🤖 自主全自動化遊戲創建（新功能！）

僅需一行命令，即可生成完整的RPG遊戲！

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

或者使用Claude Code：

自動生成一個以“賽博朋克偵探故事”為概念的RPG遊戲

自動執行的8個步驟：

1. ✅ 創建項目
2. ✅ 分析概念
3. ✅ 生成劇情（地圖、角色、事件）
4. ✅ 戰鬥系統（敵人、技能）
5. ✅ 任務系統
6. ✅ 生成AI圖像資源
7. ✅ 調整狀態平衡
8. ✅ 優化項目

⏱️ 所需時間：3 - 7分鐘 → 立即可以開始遊戲！ 詳細信息請參考 AUTONOMOUS_CREATION.md。

🎨 AI圖像生成（新功能！）

使用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圖像生成

🤖 自主遊戲創建（新功能！）

📖 AI劇情生成

🔌 插件管理

💻 使用示例

基礎用法

// 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,  // 顯示文本
  parameters: ["", 0, 0, 2]
})

add_event_command({
  project_path: "/path/to/MyFantasyRPG",
  map_id: 2,
  event_id: 1,
  page_index: 0,
  code: 401,  // 文本繼續
  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的示例項目

📊 開發狀態

🌟 特別功能

🚀 一鍵生成RPG遊戲

# 只需一個命令，即可生成完整的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許可證。

🔗 鏈接

• RPG Maker MZ 官方網站
• Model Context Protocol
• Gemini API