NHL API - 模型上下文协议

使用模型-上下文协议（MCP）模式实现的NHL API的TypeScript版本。此MCP服务器提供了对NHL数据的访问，包括球队、球员、排名、赛程和统计数据。

概览

该库通过模型-上下文协议（MCP）提供了一个干净的接口来访问NHL官方API。它允许您从NHL的API中获取数据，并通过MCP工具以结构化、易于使用的格式提供这些数据。

📊 当前状态

截至2025年3月10日，平台提供了以下功能：

✅ 正常工作的功能

1. 排名

   • 包括分区细分的全联盟排名
   • 完整的球队记录信息

2. 球队

   • 基本球队身份信息
   • 包含球员详情的当前阵容信息
   • 球队统计（滑冰者和守门员）
   • 新秀追踪

3. 球员

   • 球员传记信息
   • 当前赛季及职业生涯统计数据
   • 获奖情况

4. 赛程

   • 当前球队赛程
   • 特定日期的联赛赛程
   • 即将进行的比赛信息

5. 统计数据

   • 当前统计领先者（滑冰者和守门员）
   • 针对特定球队的统计细分

6. 比赛信息

   • 实时比赛得分与状态
   • 比赛赛程

❌ 已识别的问题

1. 球队信息缺失

   • 在查找球队时缺少球队所在分区和会议的信息
   • 基本球队数据不完整（城市/位置详情缺失）

2. 比赛详情

   • 进行中的比赛状态信息有限
   • 比赛逐球数据实现需要进一步测试

3. 历史数据

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

4. UI集成

   • 目前没有用于数据可视化的UI组件
   • 原始数据格式需要转换以便前端展示

📝 待办事项列表

高优先级

• 修复球队信息API以包含完整的球队详情（分区、会议、位置）
• 为正在进行的比赛实施更详细的状态跟踪
• 创建用于UI集成的数据转换层
• 完成对历史数据端点的测试

中等优先级

• 开发标准的数据可视化组件
• 添加球员图片集成
• 实现球队标志/品牌资产
• 创建跨所有数据类型的搜索功能

低优先级

• 构建常用数据缓存系统
• 添加幻想曲棍球集成点
• 开发新闻/媒体集成
• 添加社交媒体内容连接

🚀 快速开始

1. 克隆仓库：

   git clone https://github.com/yourusername/nhl-mcp.git
   cd nhl-mcp
   

2. 安装依赖：

   npm install
   

3. 配置API凭证：

   cp .env.example .env
   # 使用您的API密钥编辑.env文件
   

4. 启动开发服务器：

   npm run dev
   

🔧 API参考

NHL-MCP 平台提供了以下核心 API 端点：

球队

• 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: 获取当前比分和比赛状态

📄 许可证

此项目根据 MIT 许可证授权 - 详情请参阅 LICENSE 文件。

🤝 贡献

欢迎贡献！请随时提交 Pull Request。

1. 分叉仓库
2. 创建你的功能分支 (git checkout -b feature/amazing-feature)
3. 提交你的更改 (git commit -m 'Add some amazing feature')
4. 将更改推送到分支 (git push origin feature/amazing-feature)
5. 打开一个 Pull Request

📞 联系方式

项目维护者: Dylan Groos

---

注：本 README 文档基于 2025 年 3 月 10 日进行的测试记录了 NHL-MCP 项目的当前状态。该平台访问的数据受国家冰球联盟条款和条件的约束。