NHL API - 模型上下文协议
使用模型上下文协议 (MCP) 模式实现的 NHL API 的 TypeScript 实现。此 MCP 服务器提供对 NHL 数据的访问，包括球队、球员、排名、赛程和统计数据。
概述
该库使用模型上下文协议 (MCP) 为 NHL 官方 API 提供了一个简洁的接口。它允许您从 NHL 的 API 中获取数据，并通过 MCP 工具以结构化、易于使用的格式提供数据。
Related MCP server: LND MCP Server
📊 当前状态
截至 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 数据，但须遵守国家冰球联盟制定的条款和条件。