The MCP Server Game

🎮 MCP服务器游戏

一款基于文本的地牢爬虫游戏，同时具有REST API和模型上下文协议（MCP）服务器，使人工智能代理能够玩游戏。

alt text

🚀 快速开始-立即玩！

1.启动游戏服务器

./start.sh

此脚本启动游戏API（端口3000）和MCP服务器（端口3001）。

2.使用GitHub Copilot进行游戏

💡 类型 /Play 在GitHub Copilot聊天室开始玩！

这 /Play prompt将引导您与AI游戏大师一起完成地牢冒险。

3.停止服务器

当你玩完之后：

./stop.sh

______________________________________________________________________

🎯 如何玩

目标：在地牢中导航，击败敌人，收集物品，并领取 金冠 赢！

游戏机制

• ⚔️ 战斗：每次攻击造成15点伤害，敌人反击
• ❤️ 健康：从100点生命值开始，使用药水进行治疗
• 🛡️ 盾牌：阻挡所有敌人伤害，2次使用后才能突破
• 🧪 魔药：大健康药水（+50生命值），解除诅咒药水（消除诅咒，不治疗）
• 😈 诅咒：骷髅魔法师的第一次命中会诅咒你（每次行动5点生命值，绕过护盾）
• 🏆 胜利：击败地精首领，掠夺金王冠

制胜策略

1. 先收集资源：从军械库拿盾牌，从侧室拿药水
2. 小心诅咒：军械库中的骷髅魔法师会在第一次命中时诅咒你

- 诅咒每次行动造成5点生命值伤害（移动、攻击、战利品） - 诅咒绕过护盾——只有诅咒提升药水才能将其移除

1. 战略性掠夺：在掠夺集装箱宝藏之前击败守卫集装箱的敌人
2. 节约资源：为地精首领保留护盾和魔药（75点气血，20-40点伤害）
3. 管理诅咒：从金库中获得解除诅咒药水（由蜘蛛守卫）

💡 提示:

• 如果可能的话，避免与骷髅魔法师战斗，以防止被诅咒
• 如果受到诅咒，请尽快获得升咒药水，以停止持续伤害
• 地精的高伤害使护盾和全生命值变得至关重要！

项目结构

• api/ -用于地牢爬虫游戏的REST API
• mcp/ -MCP服务器，将游戏机制作为AI可访问的工具公开
• tests/ -API集成测试
• docs/ -文档和功能计划

安装和设置

1.安装依赖项

npm install

2.开始一切（推荐）

🎮 最简单的开始方法：

./start.sh    # Starts both API and MCP servers

完成后：

./stop.sh     # Stops all game servers

3.或单独启动服务器

启动游戏API：

npm start

API将于 http://localhost:3000

📖 API 文档：参观 http://localhost:3000/api-docs 用于交互式Swagger文档

启动MCP服务器（在单独的终端中）：

npm run start:mcp

MCP服务器将启动 http://localhost:3001

4.运行测试

# Test the Game API
npm test

# Test the MCP Server integration
npm run test:mcp

游戏API

REST API为玩地牢爬虫游戏提供了端点：

• POST /api/games -创建新游戏
• GET /api/games/:id -获取游戏状态
• GET /api/games -列出所有游戏
• POST /api/games/:id/action -执行动作（移动、攻击、掠夺、使用物品）

交互式API文档：服务器运行后，请访问 http://localhost:3000/api-docs 用于交互式测试的完整Swagger/OpenAPI文档。

游戏功能

敌人：

• 巨鼠 （20 HP，3 dmg）-在储藏室保护大健康药水
• 骷髅魔法师 （25生命值，5分克）-武器库中的守卫护盾，首次命中时诅咒
• 蜘蛛 （15 HP，2 dmg）-守卫诅咒金库中的提药水
• 妖精老大 （75 HP，20-40 dmg）-最后一位守护金冠的老板

项目：

• 木盾 -在突破之前阻止2次敌人攻击（不阻止诅咒伤害）
• 大健康药水 -恢复50马力
• 诅咒解除药水 -消除诅咒（无法治愈）
• 金冠 -胜利物品！

诅咒系统：

• 骷髅魔法师在第一次反击中使用
• 每次行动造成5点生命值伤害（移动、攻击、战利品）
• 旁路屏蔽保护
• 持续使用，直至使用提咒药水治愈
• 如果忽视，可能会致命

MCP 服务器

MCP服务器允许AI代理（如Claude或GitHub Copilot）使用标准化工具玩游戏：

• create_game -开始新的游戏会话
• inspect_room -获取当前房间详细信息
• move -在地牢中导航
• attack -与敌人作战
• loot -从容器中收集物品（击败守卫的敌人后）
• use_item -使用消耗品（药水）
• list_games -查看所有游戏会话

🎮 使用GitHub Copilot

类型 /Play 在GitHub Copilot聊天中开始您的冒险之旅！

这 /Play prompt提供了一种身临其境的地牢爬行体验，AI游戏大师将指导您完成战斗、探索和解谜。

玩之前，一定要跑 ./start.sh 启动游戏服务器！

看 mcp/README.md 了解详细的MCP文档。

特征规划工作流程

该项目包括一个用于深度功能规划的自定义GitHub Copilot代理。

如何使用功能规划器

1. 开始计划：在GitHub Copilot聊天中，说：

- “让我们为\[功能名称\]计划一个新功能” - “我想添加\[功能描述\]” - “帮我计划\[功能\]”

1. 参与讨论：代理人将询问以下关键问题：

- 需求和用例 - 技术影响 - 制约因素和风险

1. 审查计划：代理将创建结构化任务列表

1. 保存文档：计划将保存到 /docs/feature-plans/

功能平面图结构

所有功能计划都存储在 /docs/feature-plans/ 包括：

• 问题陈述和要求
• 技术影响分析
• 实施检查表
• 测试策略
• 风险评估

好处

• ✅ 编码前进行彻底规划
• ✅ 及早发现问题
• ✅ 明确的实施路线图
• ✅ 有文件记录的决定
• ✅ 更好的团队沟通