nba-mcp-server

🚀 NBA MCP 服务器

NBA MCP 服务器是一个用 Python 实现的 Model Context Protocol (MCP) 服务器，可提供 NBA 统计数据与实时比赛数据，为用户搭建起通往 NBA 数据的桥梁。

🚀 快速开始

NBA MCP 服务器能为应用程序提供实时比赛信息和历史统计数据。以下是基本使用示例：

from nba.mcp_server import NBAMCP

server = NBAMCP()
server.run()

✨ 主要特性

• 实时比赛数据（比分板、战力统计、逐节比赛）
• 球员信息和职业生涯统计
• 球队比赛记录和统计
• 联赛排名
• 比赛结果和赛程

📦 安装指南

Docker 运行

1. 打包镜像：

   docker build -t nba_mcp_server .
   

2. 启动容器：

   docker run -p 8000:8000 nba_mcp_server
   

直接运行

1. 安装依赖：

   pip install -r requirements.txt
   

2. 执行脚本：

   python main.py
   

💻 使用示例

基础用法

from nba.mcp_server import NBAMCP

server = NBAMCP()
server.run()

📚 详细文档

工具

实时比赛数据

• nba_live_scoreboard

  • 获取当天 NBA 的实时比分板（直播或最新）
  • 返回游戏 ID、开始时间、比分和转播信息

• nba_live_boxscore

  • 获取指定 NBA 比赛 ID 的实时战力统计
  • 提供详细的球员和球队统计数据

• nba_live_play_by_play

  • 获取特定比赛的实时逐节比赛行动
  • 包括得分、犯规、暂停和换人等信息

球员信息

• nba_common_player_info

  • 获取球员的基本信息
  • 包括个人资料、身高、体重、所属球队和位置

• nba_player_career_stats

  • 获取球员的职业生涯统计
  • 提供不同格式的统计数据（每场平均、总分、每36分钟）

• nba_list_active_players

  • 返回所有当前活跃 NBA 球员的列表

• nba_player_game_logs

  • 获取指定日期范围内球员的比赛统计

球队数据

• nba_team_game_logs_by_name

  • 使用球队名称获取球队比赛记录
  • 避免需要知道球队的数字 ID

• nba_fetch_game_results

  • 获取指定球队 ID 和时间范围内的比赛结果

• nba_team_standings

  • 获取指定赛季和赛季类型下的 NBA 球队排名

• nba_team_stats_by_name

  • 使用球队名称获取球队统计
  • 支持不同的汇总方法（总分、每场平均等）

• nba_all_teams_stats

  • 获取多个赛季中所有 NBA 球队的统计数据

赛程信息

• nba_schedule_and_roster
  • 获取指定日期的比赛安排和球队阵容
  • 包括比赛时间和对阵双方信息

🔧 技术细节

该 MCP 服务器基于以下技术实现：

• NBA API Python 包（nba_api）
• MCP 协议用于 API 接口
• Pydantic 用于输入验证
• Pandas 用于数据处理

📄 许可证

该 MCP 服务器在 MIT License 下开源。