NBA

What is NBA MCP Server?

NBA MCP Server is a tool designed to enhance Anthropic's Claude LLM by providing it with access to real-time and historical NBA game data and statistics. It leverages the open-source nba_api to achieve this, addressing Claude's current limitations in fetching such information.

How to use NBA MCP Server?

To use NBA MCP Server, follow these installation steps in the directory where you have cloned the repository:

1. Create a virtual environment:

   uv venv
   

2. Activate the virtual environment:

   .venv\Scripts\activate
   

3. Install the project in editable mode:

   uv pip install -e .
   

After installation, you need to add the configuration to your Claude config, similar to how you would configure any other MCP Server.

Key Features of NBA MCP Server

NBA MCP Server offers the following functionalities:

• Fetch Final Scores: Retrieve the final scores for all NBA games that occurred yesterday or in the past.
• Basic Player Statistics: Obtain basic points, rebounds, and assists (P/R/A) breakdowns for all players who participated in games yesterday or in the past.
• Comprehensive Player Statistics: Access full statistics including points (PTS), rebounds (REB), assists (AST), steals (STL), blocks (BLK), turnovers (TO), plus/minus (PLUS_MINUS), and minutes played (MIN) for games yesterday or in the past.
• Four Factors Analysis: Fetch the "four factors" (effective field goal percentage, turnover percentage, offensive rebounding percentage, and free throw rate) for all games that happened yesterday or in the past.

Use Cases of NBA MCP Server

• AI-powered Sports Analysis: Enable Claude LLM to perform in-depth analysis of NBA games and player performance.
• Real-time Sports Updates: Provide Claude with the ability to deliver up-to-the-minute NBA game results and statistics.
• Historical Data Research: Allow Claude to access and process historical NBA data for various research or analytical purposes.
• Fantasy Sports Assistance: Potentially assist users with fantasy basketball decisions by providing Claude with relevant player and game statistics.

FAQ about NBA MCP Server

Q: What is the primary purpose of NBA MCP Server? A: Its primary purpose is to extend the capabilities of Anthropic's Claude LLM by allowing it to fetch and process NBA game and player statistics.

Q: What data sources does NBA MCP Server use? A: It utilizes the open-source nba_api to access NBA data.

Q: Can it fetch live game data? A: The description mentions fetching data for games that "happened yesterday / in the past," suggesting it focuses on completed games rather than live updates.

Q: Is this project officially affiliated with the NBA? A: No, it is a community-driven project and not officially affiliated with the NBA.

Q: What are the "four factors" mentioned in the features? A: The "four factors" are a set of advanced basketball statistics used to evaluate team efficiency: effective field goal percentage, turnover percentage, offensive rebounding percentage, and free throw rate.

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