# cfbd-mcp-server

> MCP Server

This repository provides an MCP server that allows AI assistants to access and query college football statistics from the College Football Data API, enabling comprehensive data analysis and insights.

## Overview

- **Category:** AI
- **Language:** Python
- **Stars:** 27
- **Forks:** 4
- **Owner:** lenwood
- **GitHub:** https://github.com/lenwood/cfbd-mcp-server
- **Created:** 2024-12-20T14:27:28+00:00
- **Updated:** 2025-03-09T07:03:42+00:00
- **Source:** https://model-context-protocol.com/servers/cfbd-api-college-football-data-server

## Setup

## Setup

**Installing via Smithery**

To install College Football Data Server for Claude Desktop automatically via [Smithery](https://smithery.ai/server/cfbd):

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

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:
```bash
uv venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate
```

3.  Install dependencies:
```bash
uv pip install -e .
```

4.  Create a `.env` file in the project root and add your API key:
```bash
CFB_API_KEY=your_api_key_here
```

**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:
```bash
uv venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate
```

3.  Install dependencies:
```bash
uv pip install -e .
```

4.  Create a `.env` file in the project root and add your API key:
```bash
CFB_API_KEY=your_api_key_here
```

**Usage**

### Running the Server

Start the server:
```bash
uv run cfbd-mcp-server
```

### 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

## Tools

## Available Tools

1.  Resources (Access schema documentation for all endpoints)
2.  Tools (Query endpoints directly)
3.  Prompts (Pre-built analysis templates)