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

• Тот факт, что это произошло на дороге в неблагоприятной обстановке

Предпосылки

• Python 3.11 или выше

• Менеджер пакетов UV (рекомендуется)

• Ключ API данных студенческого футбола ( получить его можно здесь )

Установка

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

1. Откройте конфигурацию Claude Desktop по адресу:

   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

   • Windows: %APPDATA%\Claude\claude_desktop_config.json

2. Добавьте конфигурацию сервера:

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

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

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

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

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

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

Для Windows:

Для macOS:

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

6. Закройте и перезапустите 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 получают более высокие лимиты ставок

• Используйте эффективные шаблоны запросов, чтобы избежать превышения лимитов

• Изящная обраб��тка ошибок ограничения скорости

Разработка

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

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

1. Клонировать репозиторий

2. Установка зависимостей разработки:

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

Внося вклад

1. Форк репозитория

2. Создать ветку функций

3. Зафиксируйте ваши изменения

4. Толкай свою вилку

5. Отправить запрос на извлечение

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

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

1. Ошибки API-ключа

   • Убедитесь, что ваш ключ API правильно установлен в файлах .env и claude_desktop_config.json

   • Проверьте правильность ключа на collegefootballdata.com

2. Ограничение скорости

   • По возможности разнесите запросы

   • Рассмотрите возможность подписки на Patreon для более высоких лимитов

   • Реализуйте кэширование для часто используемых данных

3. Проблемы с подключением

   • Проверьте подключение к Интернету

   • Проверьте статус API на collegefootballdata.com

   • Обеспечьте правильную обработку ошибок в вашем коде

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

• Открыть вопрос на GitHub

• Ознакомьтесь с документацией API.

• Проверьте данные по студенческому футболу в Discord

Лицензия

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

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

• Данные по студенческому футболу для предоставления API

• Модель контекстного протокола для спецификации MCP