NBA数据访问服务

一个基于TypeScript构建的MCP服务器,提供对ESPN NBA API端点的访问,包括比分板、球队信息、球员数据等功能。

  • by mmartinsky
  • JavaScript
  • 本地部署
  • 更新于
在 GitHub 查看 mmartinsky/espn-mcp

使用说明

MCP ESPN

模型上下文协议(MCP)服务器,用于访问ESPN NBA API端点,使用TypeScript构建。

特性

此MCP服务器提供对ESPN的NBA API端点的访问,包括:

  • 记分牌:获取特定日期的NBA比赛
  • 团队:列出所有NBA球队或获取具体球队信息
  • 名册:获取团队名册
  • 日程:获取团队日程
  • 玩家:列出NBA球员并获取球员统计数据
  • 新闻:获取NBA新闻

安装

npm install

需求

  • Node.js 16+
  • TypeScript 5.0+

配置

将此添加到您的MCP客户端配置中(例如,Claude Desktop):

"espn-mcp": {
    "command": "/usr/local/bin/npx",
    "args": [
        "-y",
        "tsx",
        "/path/to/your/mcp-espn/src/index.ts"
    ]
}

替换 /path/to/your/ 带有克隆此存储库的实际路径。

用法

服务器提供以下工具:

espn_nba_芯板

获取特定日期的NBA记分牌。

  • date (可选):YYYYMMDD格式的日期,默认为今天

espn_nba_teams

获取所有NBA球队的名单。

espn_nba_team

获取具体的NBA球队信息。

  • team (必填):球队ID或缩写(例如,“lal”或“13”代表湖人队)

espn_nba_roster

获取NBA球队名单。

  • team (必填):团队ID或缩写

espn_nba_时间表

获取NBA球队时间表。

  • team (必填):团队ID或缩写

espn_nba_players

获取NBA球员名单。

espn_nba_player_stats

获取NBA球员统计数据。

espn_nba_新闻

获取NBA新闻。

发展

npm start      # Run the server (uses tsx)

该项目使用:

  • TypeScript 用于类型安全和更好的开发经验
  • 多伦多证券交易所 用于在开发过程中直接运行TypeScript文件
  • ES模块 用于现代JavaScript模块系统

API终点

此服务器使用公共ESPN API终结点:

  • 基本URL: http://site.api.espn.com/apis/site/v2/sports/basketball/nba

许可证

麻省理工学院