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