NHL API - 模型上下文协议

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

概述

该库使用模型上下文协议 (MCP) 为 NHL 官方 API 提供了一个简洁的接口。它允许您从 NHL 的 API 中获取数据，并通过 MCP 工具以结构化、易于使用的格式提供数据。

📊 当前状态

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

✅ 工作特点

积分榜
- 联盟排名及分区细分
- 完整的球队记录信息
团队
- 基本团队身份信息
- 当前球员名单信息及球员详情
- 球队统计数据（滑冰运动员和守门员）
- 潜在客户追踪
玩家
- 球员履历信息
- 本赛季和职业生涯统计数据
- 奖项认可
时间表
- 当前球队赛程
- 特定日期的联赛赛程
- 即将举行的比赛信息
统计数据
- 当前统计领先者（滑冰运动员和守门员）
- 特定球队的统计数据细分
游戏信息
- 实时比赛比分和状态
- 比赛日程

❌ 已发现的问题

团队信息差距
- 球队查询中缺少球队分部和会议信息
- 基本球队数据不完整（缺少城市/位置详细信息）
游戏详情
- 正在进行的游戏的状态信息有限
- 逐场数据实施需要进一步测试
史料
- 季节性历史数据访问需要验证
- 历史时间表检索需要额外的测试
UI集成
- 目前没有用于数据可视化的 UI 组件
- 原始数据格式需要转换才能在前端显示

📝 待办事项列表

高优先级

[ ] 修复团队信息 API，以包含完整的团队详细信息（部门、会议、位置）
[ ] 为直播游戏实现更详细的游戏状态追踪
[ ] 为 UI 集成创建数据转换层
[ ] 完成历史数据端点测试

中优先级

[ ] 开发标准数据可视化组件
[ ] 添加播放器图片集成
[ ] 实施团队徽标/品牌资产
[ ] 创建跨所有数据类型的搜索功能

低优先级

[ ] 为频繁访问的数据构建缓存系统
[ ] 添加梦幻冰球整合点
[ ] 发展新闻/媒体整合
[ ] 添加社交媒体内容连接

🚀 入门

克隆存储库：
git clone https://github.com/yourusername/nhl-mcp.git cd nhl-mcp
安装依赖项：
npm install
配置 API 凭证：
cp .env.example .env # Edit .env with your API keys
启动开发服务器：
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 请求。

分叉存储库
创建你的功能分支（ git checkout -b feature/amazing-feature ）
提交您的更改（ git commit -m 'Add some amazing feature' ）
推送到分支（ git push origin feature/amazing-feature ）
打开拉取请求

📞 联系方式

项目维护者：Dylan Groos

注意：本自述文件根据 2025 年 3 月 10 日进行的测试记录了 NHL-MCP 项目的当前状态。该平台访问 NHL 数据，但须遵守国家冰球联盟制定的条款和条件。

NHL MCP Server

Integrations