Skip to main content
Glama
deenesjakoruzh

cfbd-mcp-server

by lenwood
GitHub
Python
MIT License
18
  • Apple
OverviewInspectNewSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

Сервер 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 .

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

Install Server
A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Tools

View all tools

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

  1. Обзор
    1. Пример вывода
      1. Предпосылки
        1. Установка
          1. Установка через Smithery
          2. Ручная установка
        2. Использование
          1. Запуск сервера
          2. Подключение к Claude Desktop
        3. Обновление после установки
          1. Функции
            1. Ресурсы
            2. Инструменты
            3. Подсказки
          2. Ограничения API
            1. Разработка
              1. Структура проекта
              2. Подготовка к разработке
              3. Внося вклад
            2. Поиск неисправностей
              1. Общие проблемы
              2. Получение помощи
            3. Лицензия
              1. Благодарности

                Related MCP Servers

                • Choose MCP Server

                  keurcien
                  -
                  security
                  F
                  license
                  -
                  quality
                  An MCP server for Claude Desktop that allows users to query data from selected Google Cloud datasets by configuring project ID and datasets in the Claude Desktop configuration.
                  Last updated -
                  Python
                  • Apple

                • MCP Log Reader

                  klara-research
                  A
                  security
                  A
                  license
                  A
                  quality
                  A specialized MCP server that helps analyze and debug Model Context Protocol logs by providing Claude with direct access to log files across multiple platforms.
                  Last updated -
                  1
                  13
                  TypeScript
                  MIT License
                  • Apple
                  • Linux

                • Strava MCP

                  JonoCX
                  -
                  security
                  A
                  license
                  -
                  quality
                  A Claude MCP server that lets users query and analyze their Strava activity data by connecting to the Strava API.
                  Last updated -
                  Python
                  Apache 2.0

                • MCP-Soccerdata

                  yeonupark
                  -
                  security
                  A
                  license
                  -
                  quality
                  An open-source MCP server that connects to the SoccerDataAPI to deliver up-to-date football match information via natural language interactions.
                  Last updated -
                  16
                  Python
                  MIT License
                  • Apple

                View all related MCP servers

                Appeared in Searches

                New 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