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 和敵人的數量與 HP，估算玩家在房間中的生存時間。

輸入示例：

{
  "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 許可證。