Happy slice of mcp pizzaMCP.pizza

nba-mcp-server

MCP.Pizza Chef: Taidgh-Robinson

nba-mcp-server is an MCP server designed for Anthropic's Claude LLM that enables real-time retrieval of recent NBA game results and detailed player statistics. It leverages the open-source nba_api to provide comprehensive data such as final scores, player points/rebounds/assists, advanced stats, and game factors for games played recently. This server enhances Claude's ability to access up-to-date basketball data that it cannot natively fetch.

Use This MCP server To

Retrieve final scores for NBA games played yesterday Get player points, rebounds, and assists from recent games Access detailed player stats including steals and blocks Fetch advanced game metrics like four factors for recent matches Integrate NBA stats into chatbots powered by Claude LLM Provide real-time NBA game summaries in conversational AI Enable sports analytics workflows with up-to-date NBA data Support fantasy basketball apps with live player performance data

README

NBA MCP Server

Description

An MCP server for Anthropic's Claude LLM that allows the model to fetch recent NBA games and stats that it struggles to currently. It does this using the opensource nba_api

Installation

Run these steps in the directory where you have cloned the repo

uv venv
.venv\Scripts\activate
uv pip install -e .

Then add the configuration to your Claude config as you would for any other MCP Server.

Features

  • Fetch the fetch the final score for all game(s) that happened yesterday / in the past
  • Fetch the basic P/R/A breakdown for all players that played in game(s) that happened yesterday / in the past
  • Fetch the full PTS/REB/AST/STL/BLK/TO/PLUS_MINUS/MIN that happened yesterday / in the past
  • Fetch the four factors for all the game(s) that happened yesterday / in the past

nba-mcp-server FAQ

How do I install the nba-mcp-server?
Clone the repo, create and activate a virtual environment, then run 'pip install -e .'.
Which LLM does nba-mcp-server support?
It is designed primarily for Anthropic's Claude LLM but can be adapted for other LLMs like OpenAI's GPT-4 and Google's Gemini.
What NBA data can I fetch with this server?
You can fetch final scores, player stats (points, rebounds, assists, steals, blocks, turnovers), plus advanced metrics like four factors for recent games.
How does nba-mcp-server get NBA data?
It uses the open-source nba_api Python package to retrieve up-to-date NBA game and player statistics.
Can I configure the time range for the NBA data?
Currently, it fetches data for games played yesterday or in the recent past; customization may require code changes.
Is this server limited to NBA data only?
Yes, it specifically focuses on NBA games and player statistics using nba_api.
How do I integrate nba-mcp-server with Claude?
Add the server configuration to your Claude MCP config as you would with any MCP server.
Does nba-mcp-server support live game updates?
It fetches data for completed games, primarily from yesterday or recent past games, not live in-progress updates.