NBA MCP 服务器

一个使用 Python 实现的，为 NBA 统计数据和实时比赛数据提供模型上下文协议 (MCP) 的服务器。

概述

此服务器提供了一套通过 NBA API 访问 NBA 数据的工具。它充当应用程序和 NBA 数据服务之间的桥梁，提供实时比赛信息和历史统计数据。

功能

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

工具

实时比赛数据

• 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_list_todays_games
  • 返回任何特定日期的记分牌数据

用法

该服务器使用 MCP 框架实现，可以作为独立服务运行。

# 启动服务器
python nba_server.py
# 或
mcp run nba_server.py

配置

• 服务器运行的超时时间为 30 秒，以实现更可靠的运行
• 实现了信号处理程序以实现优雅关闭 (Ctrl+C)

与 Claude Desktop 一起使用

选项 1：使用 Docker（推荐）

1. 克隆此存储库

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

2. 安装依赖项

pip install -r requirements.txt

3. 构建 Docker 镜像

docker build -t nba_mcp_server .

4. 运行 Docker 容器

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

5. 将此添加到您的 claude_desktop_config.json：

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

选项 2：直接 Python 执行

1. 克隆此存储库

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

2. 创建一个新环境

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

3. 安装依赖项

pip install -r requirements.txt

4. 在终端上运行 NBA mcp 服务器

mcp run nba_server.py

5. 将此添加到您的 claude_desktop_config.json，根据需要调整 Python 路径：

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

添加您选择的配置后，重新启动 Claude Desktop 以加载 NBA 服务器。然后，您就可以在与 Claude 的对话中使用所有 NBA 数据工具。

技术细节

该服务器构建于：

• NBA API (nba_api) Python 包
• 用于 API 接口的 MCP
• 用于输入验证的 Pydantic
• 用于数据操作的 Pandas

许可证

此 MCP 服务器在 MIT 许可证下可用。