NBA MCP Server

What is NBA MCP Server?

NBA MCP Server is a Python server implementing the Model Context Protocol (MCP) to provide NBA statistics and live game data. It bridges applications to the NBA API, offering live scores, player information, team data, and historical stats.

How to use NBA MCP Server?

Clone the repository and install dependencies with pip install -r requirements.txt. Start the server using python nba_server.py or mcp run nba_server.py. Integrate with Claude Desktop by adding a Docker or direct Python entry to claude_desktop_config.json.

Key features of NBA MCP Server

• Live scoreboard and box scores
• Player info and career statistics
• Team game logs and statistics
• League standings
• Game results and schedules

Use cases of NBA MCP Server

• Monitor live NBA games with scores and play-by-play
• Retrieve player biographies and career stats
• Analyze team performance over a season
• Check current league standings
• Look up past game results or upcoming schedules

FAQ from NBA MCP Server

What dependencies does the server need?

The server uses the nba_api Python package, MCP framework, Pydantic for input validation, and Pandas for data manipulation.

How do I run NBA MCP Server with Claude Desktop?

You can run it via Docker (recommended) or direct Python. Both options require adding an entry to claude_desktop_config.json.

Does the server require an API key?

No API key is mentioned in the readme; the server accesses the public NBA API directly.

What is the default timeout?

The server runs with a 30-second timeout for more reliable operation.

How do I stop the server?

Signal handlers are implemented for graceful shutdown using Ctrl+C.