
NHL API - Model Context Protocol

2025.03.11
2
TypeScript体育数据API服务娱乐功能
NHL-MCP 是一个基于 TypeScript 实现的 NHL API 服务,采用 Model-Context Protocol (MCP) 模式。该服务提供了对 NHL 数据的访问,包括球队、球员、排名、赛程和统计数据等。主要功能包括获取联赛排名、球队信息、球员信息、赛程安排、统计数据以及实时比赛信息。适用于需要获取和处理 NHL 相关数据的应用场景,如体育数据分析、球迷应用开发等。
View on GitHub
Overview
基本能力
产品定位
NHL-MCP 是一个专门用于访问和处理 NHL(国家冰球联盟)数据的 API 服务,旨在为开发者提供结构化和易于使用的 NHL 数据接口。
核心功能
- Standings
- 联赛排名及分区详情
-
完整的球队战绩信息
-
Teams
- 球队基本信息
- 当前阵容及球员详情
- 球队统计数据(球员和守门员)
-
新秀追踪
-
Players
- 球员传记信息
- 当前赛季及职业生涯统计数据
-
获奖记录
-
Schedules
- 当前球队赛程
- 特定日期的联赛赛程
-
即将进行的比赛信息
-
Statistics
- 当前统计领先者(球员和守门员)
-
球队特定统计详情
-
Game Information
- 实时比赛得分和状态
- 比赛赛程
适用场景
- 体育数据分析应用
- 球迷应用开发
- 实时比赛信息展示
- 球队和球员数据统计
工具列表
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
: 获取当前比赛得分和状态
常见问题解答
- Team Information Gaps
- 球队分区和联盟信息缺失
-
基本球队数据不完整(缺少城市/位置详情)
-
Game Details
- 进行中比赛的详细状态信息有限
-
比赛逐场数据实现需要进一步测试
-
Historical Data
- 季节性历史数据访问需要验证
-
历史赛程检索需要额外测试
-
UI Integration
- 目前没有数据可视化的 UI 组件
- 原始数据格式需要转换以便前端显示
使用教程
使用依赖
- 确保已安装 Node.js 和 npm。
安装教程
-
克隆仓库:
git clone https://github.com/yourusername/nhl-mcp.git cd nhl-mcp
-
安装依赖:
npm install
-
配置 API 凭证:
cp .env.example .env # 编辑 .env 文件,填入你的 API 密钥
-
启动开发服务器:
npm run dev
调试方式
- 启动开发服务器后,可以通过访问 API 端点来测试功能。例如:
curl http://localhost:3000/api/get-team?teamId=1
这将返回 ID 为 1 的球队信息。