All Hearts 2025 MCP服务器
一 MCP（模型上下文协议）服务器 这使得人工智能助手（Claude、Windsurf等）能够与组织活动的多游戏竞赛平台进行交互。使用TypeScript构建 @modelcontextprotocol/sdk.
______________________________________________________________________
🎯 此MCP启用的用例
- AI驱动的游戏辅导 -AI可以检查参与情况并提醒非参与者
- 自动提交分数 -通过自然语言提交游戏结果
- 实时排行榜查询 -“我的团队怎么样了？”→ 即时统计数据
- 参与监测 -“谁还没玩过打字游戏？”
- 球员表现跟踪 -“我的军衔是什么？”→ 详细分解
- 活动协调 -检查游戏窗口，根据时间发送提醒
______________________________________________________________________
🎮 核心功能
多游戏支持
支持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传输） |
______________________________________________________________________
🚀 关键差异
- 游戏会话的完整CRUD -不仅仅是只读；可以创建和更新游戏数据
- 多房屋支持 -4栋具有个人追踪功能的竞争房屋
- 智能非参与者检测 -与已知球队名单进行比较
- 双重提交模式 -两步（创建/更新）和一步（遗留）模式
- 加密有效载荷 -敏感游戏的安全意识设计
- 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许可证
麻省理工学院