AI导哈

多游戏竞赛平台协议服务器

一个基于TypeScript的MCP服务器，支持AI助手与多游戏竞赛平台交互，实现游戏管理、参与跟踪和实时数据分析。

  • by nateshmbhat
  • JavaScript
  • 本地部署
  • 更新于
在 GitHub 查看 nateshmbhat/all-hearts-2025-mcp-server

使用说明

All Hearts 2025 MCP服务器

一 MCP（模型上下文协议）服务器 这使得人工智能助手（Claude、Windsurf等）能够与组织活动的多游戏竞赛平台进行交互。使用TypeScript构建 @modelcontextprotocol/sdk.

🎯 此MCP启用的用例

  1. AI驱动的游戏辅导 -AI可以检查参与情况并提醒非参与者
  2. 自动提交分数 -通过自然语言提交游戏结果
  3. 实时排行榜查询 -“我的团队怎么样了？”→ 即时统计数据
  4. 参与监测 -“谁还没玩过打字游戏？”
  5. 球员表现跟踪 -“我的军衔是什么？”→ 详细分解
  6. 活动协调 -检查游戏窗口，根据时间发送提醒

🎮 核心功能

多游戏支持

支持5种游戏类型： 填字游戏, Wordle, 打字, 数独，以及 记忆.

参与跟踪

工具 说明
get_game_participants 检索任何游戏的所有参与者，可按房屋/团队过滤
get_non_participants 识别尚未参加比赛的团队成员（使用内置的团队名单）

游戏会话管理（两步流程）

每个游戏都支持创建→ 更新工作流以实现精确的会话控制：

游戏 创建工具 更新工具
打字 create_typing_session update_typing_session
相声 create_crossword_session update_crossword_session
Wordle create_wordle_session update_wordle_session
数独 create_sudoku_session update_sudoku_session
记忆 create_memory_session update_memory_session

传统提交工具

一次性提交以实现向后兼容性： submit_typing_game, submit_crossword_game, submit_wordle_game, submit_sudoku_game

排行榜和分析

工具 说明
get_house_standings 所有房屋按每场比赛的总分进行排名
get_house_details 特定房屋的详细统计数据
get_top_players 总体排名前N位的球员或按球队筛选
get_player_rank 个人玩家的排名、总得分和每场比赛得分
get_game_leaderboard 特定游戏的最佳表现者

实用工具

工具 说明
get_game_timings 检索所有游戏的开始/结束时间（UTC和IST）
get_session_id 通过玩家电子邮件检索现有会话ID
get_user_by_email 从电子邮件地址获取用户的房屋和姓名
get_slack_users 获取Slack工作区用户目录

安全

  • AES加密 用于敏感游戏提交（数独使用加密有效载荷）
  • 通过CryptoJS进行加密密钥管理

📦 技术栈

组件 技术
运行时 Node.js（ES模块）
语言 TypeScript
MCP-SDK @modelcontextprotocol/sdk v1.0.4
HTTP客户端 Axios
加密 CryptoJS（AES）
传输 stdio（标准MCP传输）

🚀 关键差异

  1. 游戏会话的完整CRUD -不仅仅是只读；可以创建和更新游戏数据
  2. 多房屋支持 -4栋具有个人追踪功能的竞争房屋
  3. 智能非参与者检测 -与已知球队名单进行比较
  4. 双重提交模式 -两步（创建/更新）和一步（遗留）模式
  5. 加密有效载荷 -敏感游戏的安全意识设计
  6. 26个MCP工具 -全面覆盖游戏平台的功能

🛠 安装

cd all-hearts-mcp-server
npm install
npm run build

配置

将此添加到您的MCP客户端配置中（例如，Claude Desktop、Windsurf）：

{
  "mcpServers": {
    "all-hearts": {
      "command": "node",
      "args": ["/absolute/path/to/all-hearts-mcp-server/dist/index.js"]
    }
  }
}

📁 项目结构

all-hearts-mcp-server/
├── src/
│   ├── index.ts          # Main MCP server (26 tools)
│   ├── api-client.ts     # API client with encryption
│   ├── types.ts          # TypeScript types
│   └── team-members.ts   # Team roster for participation tracking
├── dist/                 # Compiled JavaScript
├── package.json
└── tsconfig.json

许可证

麻省理工学院

相关 MCP