🚀 NBA MCP 服务器
NBA MCP 服务器是一个用 Python 实现的 Model Context Protocol (MCP) 服务器，可提供 NBA 统计数据与实时比赛数据，为用户搭建起通往 NBA 数据的桥梁。
🚀 快速开始
NBA MCP 服务器能为应用程序提供实时比赛信息和历史统计数据。以下是基本使用示例：
from nba.mcp_server import NBAMCP
server = NBAMCP()
server.run()
✨ 主要特性
- 实时比赛数据（比分板、战力统计、逐节比赛）
- 球员信息和职业生涯统计
- 球队比赛记录和统计
- 联赛排名
- 比赛结果和赛程
📦 安装指南
Docker 运行
- 打包镜像：
docker build -t nba_mcp_server . - 启动容器：
docker run -p 8000:8000 nba_mcp_server
直接运行
- 安装依赖：
pip install -r requirements.txt - 执行脚本：
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 下开源。