NHL API - 模型上下文协议

这是一个使用模型上下文协议模式实现的 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 组件
   • 原始数据格式需要转换为前端显示

📝 TODO 列表

高优先级

• [ ] 修复球队信息 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. Fork 存储库
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 项目的当前状态。 该平台访问 NHL 数据，该数据受国家冰球联盟设定的条款和条件的约束。