NBA MCP Server

基本能力

产品定位

NBA MCP Server 是一个专门用于获取和处理 NBA 相关数据的服务，包括实时比赛数据、球员信息、球队数据和赛程信息等。

核心功能

• 实时比赛数据（比分板、技术统计、比赛回放）
• 球员信息和职业生涯统计数据
• 球队比赛记录和统计数据
• 联盟排名
• 比赛结果和赛程

适用场景

• 体育数据分析
• 实时比赛跟踪
• 球员表现分析
• 球队表现分析
• 赛程管理

工具列表

1. Live Game Data
2. nba_live_scoreboard: 获取当日 NBA 比分板（实时或最新）
3. nba_live_boxscore: 获取指定 NBA 比赛 ID 的实时技术统计

4. nba_live_play_by_play: 获取特定比赛的实时回放

5. Player Information

6. nba_common_player_info: 获取球员基本信息
7. nba_player_career_stats: 获取球员职业生涯统计数据
8. nba_list_active_players: 返回所有当前活跃的 NBA 球员列表

9. nba_player_game_logs: 获取指定日期范围内球员的比赛统计数据

10. Team Data

11. nba_team_game_logs_by_name: 使用队名获取球队比赛记录
12. nba_fetch_game_results: 获取指定球队 ID 和日期范围内的比赛结果
13. nba_team_standings: 获取指定赛季和赛季类型的 NBA 球队排名
14. nba_team_stats_by_name: 使用队名获取球队统计数据

15. nba_all_teams_stats: 获取多个赛季中所有 NBA 球队的统计数据

16. Schedule Information

17. nba_list_todays_games: 返回特定日期的比分板数据

使用教程

使用依赖

1. 克隆仓库

git clone https://github.com/obinopaul/nba-mcp-server.git
cd nba-mcp-server

1. 安装依赖

pip install -r requirements.txt

安装教程

Option 1: 使用 Docker (推荐)

1. 构建 Docker 镜像

docker build -t nba_mcp_server .

1. 运行 Docker 容器

docker run -d -p 5000:5000 --name nba_mcp_server nba_mcp_server

1. 添加到 claude_desktop_config.json:

{
  "mcpServers": {
    "nba_mcp_server": {
      "command": "docker",
      "args": [
        "exec",
        "-i",
        "nba_mcp_server",
        "python",
        "nba_server.py"
      ]
    }
  }
}

Option 2: 直接 Python 执行

1. 创建新环境

conda create --name your_env_name python=3.13
conda activate your_env_name

1. 运行 NBA mcp server

mcp run nba_server.py

1. 添加到 claude_desktop_config.json:

{
  "mcpServers": {
    "nba_mcp_server": {
      "command": "/path/to/your/python",
      "args": [
        "/path/to/nba_server.py"
      ]
    }
  }
}

调试方式

1. 启动服务器

python nba_server.py
# 或
mcp run nba_server.py

1. 服务器配置
2. 30秒超时
3. 实现了信号处理程序以优雅关闭（Ctrl+C）

许可证

该项目遵循 MIT 开源许可条款。