Сервер MCP данных студенческого футбола

Реализация сервера MCP, обеспечивающая доступ к статистике студенческого футбола, полученной из API данных студенческого футбола V2 в Claude Desktop .

Версия Python Версия API CFBD Лицензия Массачусетского технологического института значок кузнеца

Обзор

Этот сервер протокола контекста модели (MCP) позволяет помощникам и приложениям на базе искусственного интеллекта:

Запрос полной статистики и данных по студенческому футболу
Получите доступ к результатам игр, записям команд и статистике игроков.
Анализируйте данные по каждому конкретному случаю и составляйте сводки
Просмотр рейтингов и показателей вероятности выигрыша
Сравните результаты работы команды и сделайте выводы

Пользователи могут выполнять запросы, используя естественный язык.

Related MCP server: Strava MCP

Пример вывода

В. Какая игра FCS стала самым большим сюрпризом в сезоне 2014 года?

A. Позвольте мне помочь найти самую большую неожиданность FCS в 2014 году. Я просмотрю данные игр, сосредоточившись на играх между командами FCS, где наблюдался значительный разрыв в силе команд и неожиданный результат.

Данные свидетельствуют о том, что в 2014 году в FCS произошло несколько примечательных поражений, но одним из самых выдающихся стал разгром «Восточного Вашингтона» со счетом 52-59 6 сентября 2014 года. Это было особенно значимо, потому что:

Вашингтон был командой FBS из конференции Pac-12
Игра проходила на домашнем стадионе Вашингтона (Husky Stadium).
Вероятность победы «Восточного Вашингтона» составляла всего 1,4% согласно послематчевой статистике.
59 очков, набранных Eastern Washington, стали рекордом, когда-либо набранным командой FCS против соперника из Pac-12.
Вашингтон был фаворитом благодаря нескольким счетам перед игрой

Другие заметные неожиданности FCS в том сезоне:

Университет штата Северная Дакота побеждает Университет штата Айова со счетом 34-14
Бетюн-Кукман побеждает FIU со счетом 14-12
Северная Айова почти огорчила Айову (проиграла 31-23)

Однако победа «Восточного Вашингтона» над «Вашингтоном» представляется самым большим сюрпризом сезона FCS 2014 года, если учесть:

Разница в подразделениях (FCS против FBS)
Уровень противника FBS (конференция Power 5)
Разница очков и результативность в нападении аутсайдера
Историческое значение как одна из самых результативных побед FCS над командой Power 5
Тот факт, что это произошло на дороге в неблагоприятной обстановке

Предпосылки

Python 3.11 или выше
Менеджер пакетов UV (рекомендуется)
Ключ API данных студенческого футбола ( получить его можно здесь )

Установка

Установка через Smithery

Чтобы автоматически установить College Football Data Server для Claude Desktop через Smithery :

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

Клонируйте этот репозиторий:

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

Создайте и активируйте виртуальную среду:

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

Установить зависимости:

uv pip install -e .

Создайте файл .env в корне проекта и добавьте свой ключ API:

CFB_API_KEY=your_api_key_here

Ручная установка

Клонируйте этот репозиторий:

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

Создайте и активируйте виртуальную среду:

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

Установить зависимости:

uv pip install -e .

Создайте файл .env в корне проекта и добавьте свой ключ API:

CFB_API_KEY=your_api_key_here

Использование

Запуск сервера

Запустите сервер:

uv run cfbd-mcp-server

Подключение к Claude Desktop

Откройте конфигурацию Claude Desktop по адресу:
- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
- Windows: %APPDATA%\Claude\claude_desktop_config.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"
            }
        }
    }
}

Закройте и перезапустите Claude Desktop.

После перезагрузки вы можете подтвердить установку, нажав на знак плюс в левом нижнем углу текстового поля. В случае успеха вы увидите "Добавить из cfbd-mcp-server" в качестве одного из пунктов меню. Вот пример скриншота.

Скриншот успешной установки

Обновление после установки

Загрузите обновленные файлы

cd cfbd-mcp-server
git pull

Удалите существующий пакет:

uv pip uninstall cfbd-mcp-server

Удалить существующие артефакты сборки и метаданные

Для Windows:

rmdir /s /q build dist
del /s /q *.egg-info

Для macOS:

rm -rf build dist *.egg-info

Установите измененный пакет и его зависимости.

uv pip install -e .
uv sync --dev --all-extras

uv run cfbd-mcp-server

Закройте и перезапустите Claude Desktop.

Функции

Ресурсы

Документация по схеме доступа для всех конечных точек:

schema://games - Информация об игре и результаты
schema://records - Рекорды сезона команды
schema://games/teams — Подробные данные о командной игре
schema://plays - Подробная информация о воспроизведении
schema://drives — сводки и результаты по дискам
schema://play/stats - Индивидуальная статистика игры
schema://rankings — рейтинги команд по опросам
schema://metrics/wp/pregame - Вероятности победы перед игрой
schema://game/box/advanced - Расширенная статистика очков

Инструменты

Запрос конечных точек напрямую:

get-games - Извлечение данных игры
get-records - Получить записи команды
get-games-teams - Доступ к статистике командных игр
get-plays - Запрос данных по ходу игры
get-drives - Анализ информации о диске
get-play-stats - Просмотр статистики игры
get-rankings - Проверьте рейтинги команд
get-pregame-win-probability - Посмотреть вероятности выигрыша
get-advanced-box-score — доступ к подробной статистике и аналитике игры

Подсказки

Готовые шаблоны анализа:

analyze-game - Получите подробный анализ конкретной игры
analyze-team - Комплексный анализ одной команды
analyze-trends - Анализ тенденций за сезон
compare-teams - Сравнение результатов двух команд
analyze-rivalry - Анализ исторических противостояний соперников

Ограничения API

API данных студенческого футбола можно использовать бесплатно, но есть ограничение по скорости:

Бесплатный уровень: Ограниченное количество запросов в минуту
Подписчики CFBD Patreon получают более высокие лимиты ставок
Используйте эффективные шаблоны запросов, чтобы избежать превышения лимитов
Изящная обработка ошибок ограничения скорости

Разработка

Структура проекта

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

Подготовка к разработке

Клонировать репозиторий
Установка зависимостей разработки:

uv pip install -e ".[dev]"

Проведите тесты:

pytest

Внося вклад

Форк репозитория
Создать ветку функций
Зафиксируйте ваши изменения
Толкай свою вилку
Отправить запрос на извлечение

Поиск неисправностей

Общие проблемы

Ошибки API-ключа
- Убедитесь, что ваш ключ API правильно установлен в файлах .env и claude_desktop_config.json
- Проверьте правильность ключа на collegefootballdata.com
Ограничение скорости
- По возможности разнесите запросы
- Рассмотрите возможность подписки на Patreon для более высоких лимитов
- Реализуйте кэширование для часто используемых данных
Проблемы с подключением
- Проверьте подключение к Интернету
- Проверьте статус API на collegefootballdata.com
- Обеспечьте правильную обработку ошибок в вашем коде

Получение помощи

Открыть вопрос на GitHub
Ознакомьтесь с документацией API.
Проверьте данные по студенческому футболу в Discord

Лицензия

Данный проект лицензирован по лицензии MIT — подробности см. в файле LICENSE .

Благодарности

Данные по студенческому футболу для предоставления API
Модель контекстного протокола для спецификации MCP

cfbd-mcp-server