Cfbd MCP Server

🚀 American College Football Database Interface (CFBD) Model Context Protocol (MCP) Server

This server provides access to American college football data through a well - structured API, offering various data resources, tool functions, and analysis templates.

🚀 Quick Start

Prerequisites

Before you start, make sure you have the necessary environment and tools installed, such as git, uv, and pip.

📦 Installation

Clone the Repository

git clone git@github.com:username/repo.git
cd cfbd-mcp-server

Install Dependencies

uv pip install -e ".[all]"

Configure Environment Variables

1. Create a .env file:

CFBD_API_KEY=your_api_key_here

2. Update claude_desktop_config.json to add MCP tool configurations.

💻 Usage Examples

Project Structure

cfbd-mcp-server/
├── README.md
├── pyproject.toml
└── src/
    └── cfbd_mcp_server/
        ├── .env
        ├── __init__.py
        ├── cfbd_schema.py
        ├── schema_helpers.py
        └── server.py

Start the Server

uv run cfbd-mcp-server

✨ Features

Data Resources

• schema://games - Game information and score data
• schema://records - Team season records
• schema://games/teams - Detailed team game statistics
• schema://plays - Specific situation of each play
• schema://drives - Summary and results of drives
• schema://play/stats - Single - play statistics
• schema://rankings - Various ranking information
• schema://metrics/wp/pregame - Pre - game win - loss probability data
• schema://game/box/advanced - Advanced game statistics and analysis

Tool Functions

• get-games - Get game data
• get-records - View team records
• get-games-teams - Get team game statistics
• get-plays - Query the specific situation of each play
• get-drives - Analyze drive information
• get-play-stats - View offensive statistics
• get-rankings - Check team rankings
• get-pregame-win-probability - Get pre - game win - loss probability
• get-advanced-box-score - Get detailed game statistics and analysis

Analysis Templates

• analyze-game - Get a detailed analysis of a specific game
• analyze-team - View a comprehensive analysis of a single team
• analyze-trends - Analyze seasonal trends
• compare-teams - Compare the performance of two teams
• analyze-rivalry - Analyze historical match - ups between rivals

📚 Documentation

API Limits

Request Limits

• Free tier: Limited number of requests per minute.
• CFBD Patreon members can enjoy higher request limits.
• Use efficient query strategies to avoid reaching the limits.
• Handle rate - limit errors gracefully.

Development Guide

Project Structure

cfbd-mcp-server/
├── README.md
├── pyproject.toml
└── src/
    └── cfbd_mcp_server/
        ├── .env
        ├── __init__.py
        ├── cfbd_schema.py
        ├── schema_helpers.py
        └── server.py

Configure the Development Environment

1. Clone the repository to your local machine.
2. Install development dependencies:

uv pip install -e ".[dev]"

3. Run tests:

pytest tests/

📄 License

This project is licensed under the MIT License. Please refer to the LICENSE file for specific terms.

🤝 Contribution Guide

Contributions are welcome! Please read CONTRIBUTING.md first to learn how to participate in the development.

This document is the official guide for cfbd-mcp-server, aiming to help users quickly get started and use this tool.