RPG制造商MZ MCP服务器
用自然语言RPG制作游戏!这MCP(Model Context Protocol)服务器Claude Desktop啊Claude Code通过,通过AI支援事业RPG Maker MZ 的游戏开发。
🎮 告别手动单击AI一起聊天制作游戏吧!
✨ 机能
- 🎯 用自然语言制作游戏 -如果你用普通语言解释游戏AI创建
- 📚 全面的知识库 - RPG Maker MZ 的12个类别的内置文档
- 🤖 AI方案生成 -自动生成游戏故事、角色和任务
- 🗺️ 映射管理 -使用自然语言命令创建和编辑地图
- 🎭 事件系统 -交互式对话事件NPC、添加触发器
- 💾 项目管理 - RPG Maker MZ 用程序初始化和管理项目
- 🔍 智能搜索 -立即发现相关文档和最佳实践
- ⚡ 批量操作 -一次创建多个映射、项目和事件
- 📦 游戏模板 -立即使用四种预构建模板创建原型
- 🎨 AI 支持资源生成 - 将来的な画像/音声生成に拡張可能
🎯 使用例
1. 🤖 完全自动游戏生成
「平和な村を盗賊から救うファンタジーRPGを作って」AI自动生成故事、地图、角色、事件!
2. 🎨 AI驱动开发工作流
シナリオ生成 → アセット生成 → 実装 → 完成所有步骤AI支持
3. 📚 大量原型生成
快速测试多个故事概念并选择最适合的内容
4. 🔄 程控游戏开发
Python从脚本和工作流自动化工具生成游戏
5. 🧪 自动测试数据生成
立即创建游戏引擎开发测试项目
6.🎓 教育・学习
RPG Maker MZ 自动生成学习示例项目
📦 安装
前提条件
- Node.js 18 以上
- Claude Desktop 或Claude Code
- RPG Maker MZ(打开生成的项目)
步骤1:安装软件包
# npmからインストール(公開されている場合)
npm install -g rpgmaker-mz-mcp
# またはリポジトリからクローン
git clone https://github.com/yourusername/rpgmaker-mz-mcp.git
cd rpgmaker-mz-mcp
npm install
npm run build步骤2:下载知识库
在知识库中RPG Maker MZ 中所述修改相应参数的值。请单独下载:
# 例: ナレッジベースリポジトリをクローン
git clone https://github.com/yourusername/rpgmaker-knowledge.git第3步:AI助手设置
Claude Desktop 在…的情况下
Claude Desktop 编辑配置文件:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - 视窗:
%APPDATA%\Claude\claude_desktop_config.json - Linux:
~/.config/Claude/claude_desktop_config.json
添加此设置:
{
"mcpServers": {
"rpgmaker-mz": {
"command": "node",
"args": [
"/path/to/rpgmaker-mz-mcp/dist/index.js"
],
"env": {
"RPGMAKER_KNOWLEDGE_PATH": "/path/to/rpgmaker-knowledge"
}
}
}
}注意: /path/to/rpgmaker-mz-mcp 和 /path/to/rpgmaker-knowledge 将条目添加到文档注册表。
例(macOS/Linux):
{
"mcpServers": {
"rpgmaker-mz": {
"command": "node",
"args": ["$HOME/projects/rpgmaker-mz-mcp/dist/index.js"],
"env": {
"RPGMAKER_KNOWLEDGE_PATH": "$HOME/projects/rpgmaker-knowledge"
}
}
}
}例(Windows):
{
"mcpServers": {
"rpgmaker-mz": {
"command": "node",
"args": ["C:\\Users\\YourName\\projects\\rpgmaker-mz-mcp\\dist\\index.js"],
"env": {
"RPGMAKER_KNOWLEDGE_PATH": "C:\\Users\\YourName\\projects\\rpgmaker-knowledge"
}
}
}
}Claude Code 在…的情况下
在项目中 .claude/settings.json 创建:
{
"mcpServers": {
"rpgmaker-mz": {
"command": "node",
"args": ["/path/to/rpgmaker-mz-mcp/dist/index.js"],
"env": {
"RPGMAKER_KNOWLEDGE_PATH": "/path/to/rpgmaker-knowledge"
}
}
}
}了解更多信息 CLAUDE_CODE_SETUP.md 来修改标记元素的显示属性。
步骤4:重新启动和确认
Claude Desktop 或Claude Code 重新启动并测试:
「利用可能な全MCPツールをリストして」create_project、create_map、create_event 中描述的场景,使用以下步骤创建明细表,以便在概念设计中分析体量的体积。
🚀 快速启动
制作第一次的游戏(5分钟)
步骤1:创建项目
「MyFirstRPGという名前の新しいRPG Maker MZプロジェクトを~/Documents/MyFirstRPGに作成して」步骤2:生成方案
「平和な村が盗賊に脅かされ、主人公が失われた魔法の遺物を見つけなければならないファンタジーRPGシナリオを生成して」步骤3:创建地图
「次のマップを作成して:
1. 25x20タイルの村マップ「平和な村」
2. 30x15タイルの森の道「暗い森」
3. 20x20タイルの神殿ダンジョン「古代神殿」」第4步:NPC添加
「位置(10, 12)に村の長老を追加して。セリフは『ようこそ、勇敢な英雄よ!失われた遺物を見つけるために、あなたの助けが必要です。』」完了! RPG Maker MZ 打开项目开始玩!
📚 可用工具
项目管理
create_project
完整的目录结构RPG Maker MZ 创建项目
参数:
path(字符串,必需)-项目目录路径name(字符串,必需)-项目名称gameTitle(字符串,可选)-游戏中显示的游戏标题mapWidth(数字,可选)-初始映射宽度(默认值:17)mapHeight(数字,可选)-初始贴图高度(默认值:13)
使用例:
「MyRPGというプロジェクトを~/Games/MyRPGに作成、ゲームタイトルは『壮大な冒険』で」load_project
现有RPG Maker MZ 导入项目
参数:
path(字符串,必需)-项目目录路径
使用例:
「~/Games/MyRPGのプロジェクトを読み込んで」映射
create_map
为当前项目创建新映射
参数:
name(字符串,必需)-映射名称width(数字,必需)-映射宽度(平铺数)height(数字,必需)-贴图高度(平铺数)parentId(数字,可选)-层次的父映射ID
使用例:
「25x20タイルの町マップ『始まりの町』を作成して」事件系统
create_event
使用自然语言命令在地图上创建事件
参数:
mapId(数字,必需)-放置事件的映射IDname(字符串,必需)-事件名称x(数字,必需)-映射上的X坐标y(数字,必需)-映射上的Y坐标trigger(枚举类型,必需)-触发器类型:action,player_touch,event_touch,autorun,parallelcommands(数组,必需)-事件命令(请参阅下面的命令类型)graphic(对象,可选)-事件图形(角色精灵)
使用例:
「位置(10, 8)にNPCを追加、セリフは『こんにちは、旅人さん!』」命令类型
事件系统支持以下简单命令类型:
show_text -显示对话框文本
{
"type": "show_text",
"parameters": {
"text": "こんにちは、旅人さん!",
"faceName": "Actor1",
"faceIndex": 0
}
}show_choices -向玩家提供选项
{
"type": "show_choices",
"parameters": {
"choices": ["はい", "いいえ"],
"cancelType": 1
}
}transfer_player -将玩家传送到其他位置
{
"type": "transfer_player",
"parameters": {
"mapId": 2,
"x": 5,
"y": 10,
"direction": 2
}
}set_开关 -设置游戏开关(标志)
{
"type": "set_switch",
"parameters": {
"switchId": 1,
"value": true
}
}set_variable -设置游戏变量
{
"type": "set_variable",
"parameters": {
"variableId": 1,
"value": 10
}
}添加项目 -将项目授予玩家
{
"type": "add_item",
"parameters": {
"itemId": 1,
"amount": 1
}
}play_bgm -播放背景音乐
{
"type": "play_bgm",
"parameters": {
"name": "Town1",
"volume": 90,
"pitch": 100
}
}play_se -播放效果音
{
"type": "play_se",
"parameters": {
"name": "Chime1",
"volume": 90,
"pitch": 100
}
}等待 -指定时间待机
{
"type": "wait",
"parameters": {
"duration": 60
}
}AI支援
generate_scenario
从自然语言的说明生成游戏剧本
参数:
prompt(字符串,必需)-游戏的自然语言说明genre(字符串,可选)-游戏类型(幻想SF、现代等)length(枚举类型,可选)-游戏长度:short,medium,long
使用例:
「宇宙探検家が古代異星文明を発見するSF RPGシナリオを生成して」知识库
search_knowledge
RPG Maker MZ 搜索知识库
参数:
query(字符串,必需)-搜索查询categories(数组,可选)-要搜索的特定类别
使用例:
「『イベントトリガー』についてナレッジを検索して」get_knowledge
获取特定类别的完整知识
参数:
category(字符串,必需)-知识类别名称
使用例:
「イベントの完全なドキュメントを見せて」可用类别:
introduction-介绍和基本game_types-游戏类型和类型map_creation-创建和编辑地图events-事件系统和脚本test_play-测试和调试database-数据库管理enemy_encounters-与敌人战斗opening-开始序列ending-结尾序列publishing-发布和分发qa- Q&A和故障排除resources-资源和资源
get_best_practices
获取特定功能的最佳实践和提示
参数:
feature(文字列、必须)-机能名(例:“events”,“maps”,“battle”)
使用例:
「バランスの取れた戦闘を作るベストプラクティスは?」批量操作
batch_create
一次创建多个实体(地图、事件、项目、技能、护具和武器)
参数:
projectPath(字符串,必需)-项目目录路径entityType(枚举类型,必需)-要创建的实体类型:map,event,item,skill,armor,weaponcount(数字,必需)-要创建的数字(1-100)template(对象,必需)-模板设置
- baseName (字符串)-基本名称 - properties (对象)-模板属性
autoIncrement(真伪值,可选)-自动对名称进行序号(默认值:true)
使用例:
「10個の回復アイテムを作成して。ポーション、ハイポーション...と強化されていくように」「5つの森マップを連続して作成して」特徴:
- 自动调整进度值(威力、价格等)
- 快速生成具有相同结构的实体
- 最适合原型
apply_template
应用预构建的游戏模板
参数:
projectPath(字符串,必需)-项目目录路径templateName(枚举类型,必需)-模板名称:basic_rpg,action_rpg,visual_novel,dungeon_crawlercustomize(对象,可选)-自定义选项
- theme (字符串)-自定义主题 - difficulty (列举型)-难易度: easy, normal, hard
使用例:
「basic_rpgテンプレートを適用して」「dungeon_crawlerテンプレートを適用、難易度はhardで」可用模板:
- basic_rpg -传统的回合制RPG
- 城镇、迷宫、老板房间 - NPC、商品商店 - 基本恢复项目和技能
- action_rpg -注重行动RPG
- 中心世界,战斗竞技场 - 训练场、宝物库 - 快速战斗技能
- 视觉小说 -重视故事的游戏
- 对话房间、选择系统 - 以角色为中心的活动 - 最小限度的战斗
- 地牢_克劳勒 -迷宫探索RPG
- 多层迷宫 - 宝箱和陷阱 - 探索重视
📖 使用例
示例1:完全幻想RPG
1. 「FantasyQuestというプロジェクトを~/Games/FantasyQuestに作成」
2. 「ファンタジーRPGシナリオを生成:
- 平和な村が暗黒の力に脅かされている
- 主人公は4つの元素クリスタルを集めなければならない
- 各クリスタルは強力なボスに守られている
- ジャンル: ファンタジー、長さ: 中程度」
3. 「25x20の村マップ『希望の村』を作成」
4. 「(12, 10)に村の長老を追加、クエストを与える」
5. 「30x30の森ダンジョン『炎のクリスタル洞窟』を作成」
6. 「森ダンジョンの中央にボス戦イベントを追加」例2:现代推理游戏
1. 「DetectiveMysteryというプロジェクトを~/Games/DetectiveMysteryに作成」
2. 「現代ミステリーシナリオを生成:
- 探偵が屋敷の殺人事件を調査
- 5人の容疑者とアリバイ
- 手がかりを集めて事件を解決
- ジャンル: 現代、長さ: 短編」
3. 「40x30の屋敷マップ『殺人屋敷』を作成」
4. 「異なる部屋に5人のNPC容疑者を追加」
5. 「屋敷全体に手がかり発見イベントを作成」示例3:RPG Maker 学习
1. 「RPG Maker MZ の紹介を見せて」
2. 「面白いイベントの作り方は?」
3. 「マップデザインのベストプラクティスは?」
4. 「『戦闘システム』についてナレッジを検索」
5. 「これらの概念を練習するためのテストプロジェクトを作成」🔗 统合
Serena MCP 并用
由于增强的代码智能MCP一起使用:
{
"mcpServers": {
"rpgmaker-mz": {
"command": "node",
"args": ["/path/to/rpgmaker-mz-mcp/dist/index.js"],
"env": {
"RPGMAKER_KNOWLEDGE_PATH": "/path/to/rpgmaker-knowledge"
}
},
"serena": {
"command": "npx",
"args": ["-y", "serena-mcp"],
"env": {
"SERENA_LOG_LEVEL": "info"
}
}
}
}🛠️ 开発
从源构建
git clone https://github.com/yourusername/rpgmaker-mz-mcp.git
cd rpgmaker-mz-mcp
npm install
npm run build开发模式
npm run dev项目结构
rpgmaker-mz-mcp/
├── src/
│ ├── index.ts # メインMCPサーバー
│ ├── types.ts # TypeScript型定義
│ ├── knowledge-base.ts # ナレッジベースマネージャー
│ └── rpgmaker-manager.ts # プロジェクト&ファイルマネージャー
├── dist/ # コンパイル済みJavaScript
├── package.json
├── tsconfig.json
└── README.md📋 开発状况
| 机能 | 状态 |
|---|
|项目创建和管理|✅ 已完成 |地图制作·编辑|✅ 已完成 |创建、编辑事件|✅ 已完成 数据库编辑✅ 已完成 | AI方案生成✅ 已完成 知识库集成✅ 已完成 |自然语言命令|✅ 已完成 | Claude Desktop支持✅ 已完成 | Claude Code支持✅ 已完成 | AI画像生成 | 🚧 計画中 | | AI音声生成 | 🚧 計画中 | 视觉地图编辑器🚧 正在计划 |插件开发|🚧 正在计划
🤝 貢献
欢迎贡献!可贡献的领域:
- 其他事件命令类型
- 加强数据库管理
- 资源生成集成
- 测试基础设施
- 文档改进
- 示例项目和模板
📄 许可证
MIT License - 了解更多信息LICENSE 浏览文件
🙏 谢辞
📞 支持
- 文档:详细示例包括: 用法.md 的双曲正切值
- 安装帮助:故障排除 安装.md 的双曲正切值
- 体系结构:技术详细信息 项目_奥维德.md 的双曲正切值
- 快速启动:5分钟导游 QUICKSTART.md 的双曲正切值
- 克劳德代码: Claude Code专用向导是 CLAUDE_CODE_SETUP.md 的双曲正切值
🎮 来,做吧!
从今天开始AI支援很棒RPG开始制作吧!
「一緒にゲームを作ろう!」______________________________________________________________________
RPG Maker为了社区❤️ 的规格化距离的幂函数
