shield_lock
JinDaGe
Contact
← Back to MCP directory
publicPublicdnsLocal runtime

rpgmaker-mz-mcp

这是一个为RPG Maker MZ游戏开发提供完整MCP服务器的工具，支持通过MCP工具和AI（Gemini）自动生成游戏项目、地图、事件、数据库内容及游戏资产，实现无需GUI的编程式或AI驱动式游戏开发。

article

README

🚀 🎮 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)

📦 安装指南

可用工具

🎮 项目管理

| 工具 | 说明 | |------|------| | 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分析 |

🤖 自主游戏创建（新功能！）

| 工具 | 说明 | |------|------| | autonomous_create_game | 根据概念自动生成完整的RPG游戏（8个步骤全自动化） |

📖 AI剧情生成

| 工具 | 说明 | |------|------| | generate_scenario | 使用Gemini AI生成完整的RPG剧情 | | implement_scenario | 将生成的剧情应用到项目中 | | generate_and_implement_scenario | 一步完成剧情生成和应用 | | generate_scenario_variations | 生成多个剧情变体 |

🔌 插件管理

| 工具 | 说明 | |------|------| | list_plugins | 显示插件列表 |

💻 使用示例

基础用法

// 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的示例项目

📊 开发状态

| 功能 | 状态 | |------|------| | ✅ 项目创建与管理 | 完成 | | ✅ 地图创建与编辑 | 完成 | | ✅ 事件创建与编辑 | 完成 | | ✅ 数据库编辑 | 完成 | | ✅ AI图像生成 (Gemini 2.5 Flash) | 完成 | | ✅ AI剧情自动生成 | 新功能！ | | ✅ 上下文工程 | 完成 | | ✅ 完整的游戏创建工作流程 | 完成 |

🌟 特别功能

🚀 一键生成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许可证。

🔗 链接

**🎮 仅使用MCP工具即可完全创建RPG Maker MZ游戏！ 🎮** 由 [ShunsukeHayashi](https://github.com/ShunsukeHayashi) 用心打造
help

Runtime guide

cloud

Hosted runtime

Hosted servers run from a provider-managed environment. You usually connect the MCP client to the hosted endpoint or follow the provider's authorization flow, without keeping a local process alive

  1. Open provider connection page
  2. Authorize or copy endpoint
  3. Connect from your MCP client
terminal

Local runtime / other methods

Local servers run on your own machine or infrastructure. You normally copy the server_config into your MCP client, install the required package, and provide env variables from env_schema when needed

  1. Copy server_config
  2. Install required package
  3. Fill env variables and restart client