Сервер MCP данных студенческого футбола
Реализация сервера MCP, обеспечивающая доступ к статистике студенческого футбола, полученной из API данных студенческого футбола V2 в Claude Desktop .
Обзор
Этот сервер протокола контекста модели (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 :
- Клонируйте этот репозиторий:
- Создайте и активируйте виртуальную среду:
- Установить зависимости:
- Создайте файл
.env
в корне проекта и добавьте свой ключ API:
Ручная установка
- Клонируйте этот репозиторий:
- Создайте и активируйте виртуальную среду:
- Установить зависимости:
- Создайте файл
.env
в корне проекта и добавьте свой ключ API:
Использование
Запуск сервера
Запустите сервер:
Подключение к Claude Desktop
- Откройте конфигурацию Claude Desktop по адресу:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json
- Windows:
%APPDATA%\Claude\claude_desktop_config.json
- macOS:
- Добавьте конфигурацию сервера:
- Закройте и перезапустите Claude Desktop.
После перезагрузки вы можете подтвердить установку, нажав на знак плюс в левом нижнем углу текстового поля. В случае успеха вы увидите "Добавить из cfbd-mcp-server" в качестве одного из пунктов меню. Вот пример скриншота.
Обновление после установки
- Загрузите обновленные файлы
- Удалите существующий пакет:
- Удалить существующие артефакты сборки и метаданные
Для Windows:
Для macOS:
- Установите измененный пакет и его зависимости.
- Закройте и перезапустите 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 получают более высокие лимиты ставок
- Используйте эффективные шаблоны запросов, чтобы избежать превышения лимитов
- Изящная обраб��тка ошибок ограничения скорости
Разработка
Структура проекта
Подготовка к разработке
- Клонировать репозиторий
- Установка зависимостей разработки:
- Проведите тесты:
Внося вклад
- Форк репозитория
- Создать ветку функций
- Зафиксируйте ваши изменения
- Толкай свою вилку
- Отправить запрос на извлечение
Поиск неисправностей
Общие проблемы
- Ошибки API-ключа
- Убедитесь, что ваш ключ API правильно установлен в файлах
.env
иclaude_desktop_config.json
- Проверьте правильность ключа на collegefootballdata.com
- Убедитесь, что ваш ключ API правильно установлен в файлах
- Ограничение скорости
- По возможности разнесите запросы
- Рассмотрите возможность подписки на Patreon для более высоких лимитов
- Реализуйте кэширование для часто используемых данных
- Проблемы с подключением
- Проверьте подключение к Интернету
- Проверьте статус API на collegefootballdata.com
- Обеспечьте правильную обработку ошибок в вашем коде
Получение помощи
- Открыть вопрос на GitHub
- Ознакомьтесь с документацией API.
- Проверьте данные по студенческому футболу в Discord
Лицензия
Данный проект лицензирован по лицензии MIT — подробности см. в файле LICENSE .
Благодарности
- Данные по студенческому футболу для предоставления API
- Модель контекстного протокола для спецификации MCP
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
Сервер MCP, предоставляющий доступ к статистике студенческого футбола, полученной из API данных студенческого футбола в Claude Desktop.
Related MCP Servers
- -securityFlicense-qualityProvides 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
- -securityAlicense-qualityAn MCP server that integrates with the AlphaVantage financial data API, providing access to stock market data, technical indicators, and fundamental financial information.Last updated -PythonMIT License
- -securityFlicense-qualityMCP 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 -3JavaScript
- -securityFlicense-qualityAn 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
Appeared in Searches
- Accessing Facebook Settings and Preferences
- A service for accessing music through Apple Music
- A tool for finding maps or creating visual representations
- Setting up productivity and collaboration tools like Google Sheets, Docs, Airtable, Slack, and more
- A server for discovering sports-related information