Nba MCP Python

NBA MCP 服务器（Python）

一个模型上下文协议（MCP）服务器，提供实时和历史NBA数据的访问。查询比赛比分、球员统计数据、球队排名以及历史表现数据。

特点/功能

• 实时比赛数据获取今日比赛的实时比分和比赛状态
• 历史游戏按特定日期查询游戏
• 玩家统计数据当前赛季统计数据，包括得分、篮板、助攻等
• 团队排名当前NBA球队排名，包括胜场、负场及排名
• 历史数据查看往季球员和球队统计数据
• 团队分析高级团队指标和绩效数据

安装

使用 pip

cd nba-mcp-python
pip install -e .

使用紫外线（推荐）

cd nba-mcp-python
uv pip install -e .

用法

作为MCP服务器

将此服务器添加到您的MCP客户端配置中。对于Claude Desktop，请在您的配置文件中添加：

macOS（苹果电脑操作系统）： ~/Library/Application Support/Claude/claude_desktop_config.json Windows： %APPDATA%/Claude/claude_desktop_config.json

直接使用Python

{
  "mcpServers": {
    "nba": {
      "command": "python",
      "args": ["-m", "nba_mcp_server.server"],
      "env": {
        "PYTHONPATH": "/absolute/path/to/nba-mcp-python/src"
      }
    }
  }
}

使用紫外线（推荐）

{
  "mcpServers": {
    "nba": {
      "command": "uv",
      "args": ["--directory", "/absolute/path/to/nba-mcp-python", "run", "nba-mcp-server"]
    }
  }
}

可用工具

1. get_todays_games

获取今日NBA比赛的实时比分和比赛状态。

参数无

示例:

Get today's NBA games

2. get_games_by_date

获取特定日期的NBA比赛信息。

参数:

• date （字符串，必填）：日期，格式为YYYY-MM-DD

示例:

Get NBA games from 2024-10-13

3. get_player_stats

获取当前赛季球员统计数据。

参数：

• playerName （字符串，可选）：按玩家名称过滤
• limit （数字，可选）：要返回的最大玩家数量（默认：50）

示例:

Get stats for LeBron James
Get top 20 player stats

4. get_team_standings

获取当前NBA球队排名。

参数无

示例：

Show me the current NBA standings

5. get_historical_player_stats

获取特定赛季的历史球员统计数据。

参数：

• playerId （字符串，必填）：NBA球员ID
• season (字符串，必填)：赛季以YYYY-YY格式表示

示例：

Get LeBron James stats from 2020-21 season

6. get_team_stats

获取特定赛季的球队统计数据。

参数：

• season （字符串，可选）：以 YYYY-YY 格式表示的赛季（默认：当前赛季）

示例：

Get team stats for 2023-24 season

发展

直接运行服务器

cd nba-mcp-python
export PYTHONPATH="${PYTHONPATH}:$(pwd)/src"
python -m nba_mcp_server.server

测试API

import asyncio
from nba_mcp_server.nba_api import get_todays_games, get_games_by_date

async def test():
    # Get today's games
    games = await get_todays_games()
    print(f"Found {len(games)} games today")

    # Get games for a specific date
    games = await get_games_by_date("2024-10-22")
    for game in games:
        print(f"{game.away_team} @ {game.home_team}: {game.game_status}")

asyncio.run(test())

数据源

这个服务器使用ESPN的公开API来获取数据。该API提供了所有NBA比赛和球员的全面统计数据和比赛信息。

项目结构

nba-mcp-python/
├── src/
│   └── nba_mcp_server/
│       ├── __init__.py       # Package initialization
│       ├── nba_api.py        # NBA API client
│       └── server.py         # MCP server implementation
├── pyproject.toml            # Project metadata and dependencies
├── requirements.txt          # Python dependencies
└── README.md                 # This file

许可证

麻省理工学院（MIT）