Skip to main content
Glama

cfbd-mcp-server

by lenwood
MIT License
9
  • Apple

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

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

Обзор

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

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

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

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

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

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

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

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

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

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

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

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

Предпосылки

Установка

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

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

npx -y @smithery/cli install cfbd --client claude
  1. Клонируйте этот репозиторий:
git clone https://github.com/yourusername/cfbd-mcp-server cd cfbd-mcp-server
  1. Создайте и активируйте виртуальную среду:
uv venv source .venv/bin/activate # On Windows: .venv\Scripts\activate
  1. Установить зависимости:
uv pip install -e .
  1. Создайте файл .env в корне проекта и добавьте свой ключ API:
CFB_API_KEY=your_api_key_here

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

  1. Клонируйте этот репозиторий:
git clone https://github.com/yourusername/cfbd-mcp-server cd cfbd-mcp-server
  1. Создайте и активируйте виртуальную среду:
uv venv source .venv/bin/activate # On Windows: .venv\Scripts\activate
  1. Установить зависимости:
uv pip install -e .
  1. Создайте файл .env в корне проекта и добавьте свой ключ API:
CFB_API_KEY=your_api_key_here

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

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

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

uv run cfbd-mcp-server

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

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

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

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

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

  1. Загрузите обновленные файлы
cd cfbd-mcp-server git pull
  1. Удалите существующий пакет:
uv pip uninstall cfbd-mcp-server
  1. Удалить существующие артефакты сборки и метаданные

Для Windows:

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

Для macOS:

rm -rf build dist *.egg-info
  1. Установите измененный пакет и его зависимости.
uv pip install -e . uv sync --dev --all-extras
uv run cfbd-mcp-server
  1. Закройте и перезапустите 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

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

  1. Клонировать репозиторий
  2. Установка зависимостей разработки:
uv pip install -e ".[dev]"
  1. Проведите тесты:
pytest

Внося вклад

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

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

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

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

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

Лицензия

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

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

Related MCP Servers

  • -
    security
    F
    license
    -
    quality
    Provides programmatic access to comprehensive football statistics and live match data via API-Football, enabling applications to retrieve league standings, team fixtures, player statistics, and real-time match events.
    Last updated -
    Python
  • -
    security
    A
    license
    -
    quality
    An MCP server that integrates with the AlphaVantage financial data API, providing access to stock market data, technical indicators, and fundamental financial information.
    Last updated -
    Python
    MIT License
    • Linux
    • Apple
  • -
    security
    F
    license
    -
    quality
    MCP server for the Clash of Clans API. Can get player, clan information, analyze ongoing wars, as well as war logs (provided they are public).
    Last updated -
    3
    JavaScript
  • -
    security
    F
    license
    -
    quality
    An MCP server that integrates with the BoardGameGeek XML API, allowing Claude to search for board games, retrieve game details, and access user collections.
    Last updated -
    TypeScript
    • Apple

View all related MCP servers

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/lenwood/cfbd-mcp-server'

If you have feedback or need assistance with the MCP directory API, please join our Discord server