College Football Data MCP Server

An MCP server implementation providing access to college football statistics sourced from the College Football Data API V2 within Claude Desktop.

Overview

This Model Context Protocol (MCP) server enables AI assistants and applications to:

• Query comprehensive college football statistics and data
• Access game results, team records, and player statistics
• Analyze play-by-play data and drive summaries
• View rankings and win probability metrics
• Compare team performances and generate insights

Users can run queries using natural language.

Prerequisites

• Python 3.11 or higher
• UV package manager (recommended)
• A College Football Data API key (get one here)

Installation# Installing via Smithery

To install College Football Data Server for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install cfbd --client claude

1. Clone this repository:

git clone https://github.com/yourusername/cfbd-mcp-server
cd cfbd-mcp-server

2. Create and activate a virtual environment:

uv venv
source .venv/bin/activate # On Windows: .venv\Scripts\activate

3. Install dependencies:

uv pip install -e .

4. Create a .env file in the project root and add your API key:

CFB_API_KEY=your_api_key_here
```\n\n### Manual Installation
1. Clone this repository:
```bash
git clone https://github.com/yourusername/cfbd-mcp-server
cd cfbd-mcp-server

2. Create and activate a virtual environment:

uv venv
source .venv/bin/activate # On Windows: .venv\Scripts\activate

3. Install dependencies:

uv pip install -e .

4. Create a .env file in the project root and add your API key:

CFB_API_KEY=your_api_key_here

Usage# Running the Server

Start the server:

uv run cfbd-mcp-server
```\n\n### Connecting with Claude Desktop
1. Open your Claude Desktop configuration at:
- macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
- Windows: `%APPDATA%\Claude\claude_desktop_config.json`
2. Add the server configuration:
```json
{
  "mcpServers": {
    "cfbd-mcp-server": {
      "command": "uv",
      "args": ["--directory", "/full/path/to/cfbd-mcp-server", "run", "cfbd-mcp-server"],
      "env": {"CFB_API_KEY": "xxx", "PATH": "/full/path/to/python"}
    }
  }
}

3. Close then restart Claude Desktop.

License

This project is licensed under the MIT License - see the LICENSE file for details.