NHL API - Model Context Protocol

NHL API - Model Context Protocol

site icon
2025.03.11 2
TypeScript体育数据API服务娱乐功能
NHL-MCP 是一个基于 TypeScript 实现的 NHL API 服务,采用 Model-Context Protocol (MCP) 模式。该服务提供了对 NHL 数据的访问,包括球队、球员、排名、赛程和统计数据等。主要功能包括获取联赛排名、球队信息、球员信息、赛程安排、统计数据以及实时比赛信息。适用于需要获取和处理 NHL 相关数据的应用场景,如体育数据分析、球迷应用开发等。
View on GitHub

Overview

基本能力

产品定位

NHL-MCP 是一个专门用于访问和处理 NHL(国家冰球联盟)数据的 API 服务,旨在为开发者提供结构化和易于使用的 NHL 数据接口。

核心功能

  1. Standings
  2. 联赛排名及分区详情
  3. 完整的球队战绩信息

  4. Teams

  5. 球队基本信息
  6. 当前阵容及球员详情
  7. 球队统计数据(球员和守门员)
  8. 新秀追踪

  9. Players

  10. 球员传记信息
  11. 当前赛季及职业生涯统计数据
  12. 获奖记录

  13. Schedules

  14. 当前球队赛程
  15. 特定日期的联赛赛程
  16. 即将进行的比赛信息

  17. Statistics

  18. 当前统计领先者(球员和守门员)
  19. 球队特定统计详情

  20. Game Information

  21. 实时比赛得分和状态
  22. 比赛赛程

适用场景

  • 体育数据分析应用
  • 球迷应用开发
  • 实时比赛信息展示
  • 球队和球员数据统计

工具列表

  • get-team: 获取球队基本信息
  • get-team-roster: 获取当前球队阵容
  • get-team-stats: 获取球队统计数据
  • get-team-prospects: 获取球队新秀信息
  • get-player-landing: 获取球员详细信息
  • get-current-standings: 获取当前 NHL 排名
  • get-schedule: 获取赛程信息
  • get-current-schedule: 获取球队即将进行的赛程
  • get-date-schedule: 获取特定日期的赛程
  • get-current-stat-leaders: 获取当前统计领先者
  • get-current-goalie-leaders: 获取当前守门员统计领先者
  • get-scores-now: 获取当前比赛得分和状态

常见问题解答

  1. Team Information Gaps
  2. 球队分区和联盟信息缺失
  3. 基本球队数据不完整(缺少城市/位置详情)

  4. Game Details

  5. 进行中比赛的详细状态信息有限
  6. 比赛逐场数据实现需要进一步测试

  7. Historical Data

  8. 季节性历史数据访问需要验证
  9. 历史赛程检索需要额外测试

  10. UI Integration

  11. 目前没有数据可视化的 UI 组件
  12. 原始数据格式需要转换以便前端显示

使用教程

使用依赖

  1. 确保已安装 Node.js 和 npm。

安装教程

  1. 克隆仓库: git clone https://github.com/yourusername/nhl-mcp.git cd nhl-mcp

  2. 安装依赖: npm install

  3. 配置 API 凭证: cp .env.example .env # 编辑 .env 文件,填入你的 API 密钥

  4. 启动开发服务器: npm run dev

调试方式

  1. 启动开发服务器后,可以通过访问 API 端点来测试功能。例如: curl http://localhost:3000/api/get-team?teamId=1 这将返回 ID 为 1 的球队信息。

许可证

该项目遵循 MIT 开源许可条款。