mcp-game-helper

🚀 游戏助手 MCP 协议

MCP 游戏助手 是一个自定义模型上下文协议（MCP）服务器，它借助 AI 驱动的工具，助力游戏开发者开展战斗平衡分析、技能评估、等级推进规划以及战斗模拟等工作。

该助手专为与 Cursor 集成打造，使用官方 @modelcontextprotocol/sdk

🚀 快速开始

🔍 可用命令

1. suggest_balancing

此命令用于分析两个实体的生命值（HP）和伤害值，从而评估它们之间的战斗是否平衡。

• 输入示例：

{
  "player": { "hp": 2040, "damage": 1500 },
  "enemy": { "hp": 2080, "damage": 1000 }
}

• 提示示例：

我要检查我的玩家和敌人是否平衡。
玩家：2040 HP，1500 伤害
敌人：2080 HP，1000 伤害

2. simulate_combat

该命令可模拟战斗场景，并估算两个实体的击杀时间（TTK）。

• 输入示例：

{
  "player": { "hp": 100, "damage": 10, "attackSpeed": 1.0 },
  "enemy": { "hp": 80, "damage": 20, "attackSpeed": 0.5 }
}

• 提示示例：

玩家：100 HP，10 伤害，攻击速度 1.0
敌人：80 HP，20 伤害，攻击速度 0.5

3. simulate_room_survival

此命令能根据玩家的每秒伤害输出（DPS）以及敌人的数量和生命值，估算玩家在房间中的生存时间。

• 输入示例：

{
  "player": { "damage": 15, "attackSpeed": 2 },
  "enemies": [{ "hp": 50 }, { "hp": 60 }]
}

• 提示示例：

玩家：伤害 15，攻击速度 2
敌人：
- 敌人 1：50 HP
- 敌人 2：60 HP

4. suggest_ai_state_machine

该命令可根据自然语言描述生成 AI 状态机的建议。

• 输入示例：

{
  "description": "当玩家靠近时，敌人进入警戒状态；否则保持巡逻。"
}

• 提示示例：

当玩家靠近时，敌人进入警戒状态；否则保持巡逻。
你能提供一个状态机的建议吗？

📦 安装指南

🏠 本地运行步骤

1. 安装依赖项：

npm install

2. 构建项目：

npm run build

3. 全局安装包：

npm install -g .

4. 在 .cursor-config.json 中注册服务器：

{
  "mcpServers": {
    "mcp-game-helper": {
      "command": "npx",
      "args": ["-y", "mcp-game-helper"]
    }
  }
}

💡 贡献

欢迎大家贡献对游戏开发者有用的命令，尤其是那些与 AI、平衡和模拟相关的功能！

📄 许可证

本项目采用 MIT 许可证。