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 '添加一些精彩的功能')
4. 推送到分支 (git push origin feature/amazing-feature)
5. 打开一个Pull Request

📞 联系

项目维护人：Dylan Groos

---

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