football-docs MCP
MCP-сервер с поиском по документации 31 провайдера футбольных данных: StatsBomb, Opta, Wyscout и другие. Context7 для футбола.
- 226 ★ репозитория
- Последний коммит
Минимальный доступ
Почему такой уровень
- Сервер читает локальный индекс документации, а запросы идут во внешний реестр Reep только при настроенном ключе.
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/football-docsОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемМинимальный доступИнструмент ничего не запускает и не ходит в сеть.
- Сервер читает локальный индекс документации, а запросы идут во внешний реестр Reep только при настроенном ключе.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
football-docs дает агенту индекс документации по 31 провайдеру и инструменту футбольных данных: типы событий, идентификаторы квалификаторов, системы координат, конечные точки API, модели данных и сравнения между провайдерами. В индексе поставщики данных (StatsBomb, Opta, Wyscout, Impect, SkillCorner, Sportradar, TheSportsDB и другие), открытые библиотеки (`kloppy`, `mplsoccer`, `socceraction`, `soccerdata`, `floodlight`) и API спортивной науки (STATSports, Firstbeat, Hawkin Dynamics, VALD). Агент ищет в реальной документации с указанием источника и версии, а не угадывает по обучающим данным: идентификаторы квалификаторов Opta, диапазоны координат StatsBomb и сигнатуры методов меняются между версиями. Инструменты: `search_docs`, `resolve_provider_id`, `get_provider_docs`, `list_providers`, `compare_providers`, `request_update` и `resolve_entity`, который сопоставляет игрока, команду или матч с идентификаторами у каждого провайдера через реестр Reep. Сервер запускается командой `npx -y football-docs` на Node.js 22.13 или новее и использует встроенную SQLite без сборки нативных модулей.
Для кого. Аналитикам и разработчикам, которые строят футбольную аналитику с Claude Code, Cursor или VS Code Copilot и работают с данными разных провайдеров.
Подходит, если
- Надо узнать, как Opta кодирует квалификаторы события, не полагаясь на память модели.
- Нужно сравнить, как StatsBomb и Wyscout описывают координаты на поле.
- Игрока нужно сопоставить с идентификаторами у разных провайдеров.
- Перед скриптом на `kloppy` или `mplsoccer` проверяется сигнатура метода.
Не подходит, если
- Нужны сами данные матчей: сервер отдает документацию, а не события и статистику.
- Работа идет с провайдером вне индекса: для него ответа не будет, сервер сообщит об этом.
- Агент не поддерживает MCP.
Пример запроса к агенту
Через football-docs найди, как Opta кодирует тип события пасс и квалификаторы длины паса, и приведи источник.MCP
- Транспорт
- stdio
- Авторизация
- не нужна
Переменные окружения
REEP_API_KEYсекрет- Ключ Reep API для инструмента resolve_entity, если нет локальной копии реестра.
REEP_DUCKDB_PATH- Путь к локальной копии бесплатного реестра Reep.
Ограничения
Сервер отдает документацию и справочные факты, а данные матчей и событий придется брать у самих провайдеров. Для `resolve_entity` нужна локальная копия бесплатного реестра Reep (`REEP_DUCKDB_PATH`) или ключ `REEP_API_KEY`, который выдается вручную по запросу. Нужен Node.js 22.13 или новее. После обновления через `npx` уже запущенный сервер работает на старой версии, пока его не переподключат (в Claude Code командой `/mcp`). Файл лицензии в репозитории не обнаружен. Последний коммит сделан в ноябре 2026.
Как отключить. Выполните `claude mcp remove football-docs` или удалите запись `football-docs` из конфигурации Cursor, VS Code либо Claude Desktop и перезапустите агента.
Частые вопросы
Как подключить football-docs к Claude Code?
Выполните `claude mcp add football-docs -- npx -y football-docs`. Нужен Node.js 22.13 или новее.
Какие провайдеры в индексе?
31 провайдер и инструмент: StatsBomb, Opta, Wyscout, Impect, SkillCorner, Sportradar, TheSportsDB, библиотеки `kloppy`, `mplsoccer`, `socceraction` и API STATSports, Firstbeat, VALD.
Что делать, если провайдера нет в индексе?
Вызовите `request_update`: запрос встанет в локальную очередь и подскажет подходящий шаблон обращения на GitHub.
Откуда берутся ответы?
Из индексированной документации с источником и версией, поэтому видно, откуда взят каждый ответ.
Как обновить сервер?
`npx` обновляет кэш сам, а работающий сервер нужно переподключить: в Claude Code командой `/mcp`.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыНавык и пакет на Python по ссылке WhoScored собирают отчет о матче: карты передач, удары, xG и дашборды игроков.
Агент запрашивает метрики, логи и трассы из GreptimeDB на SQL, TQL и RANGE, с запретом записи и маскировкой чувствительных данных
Один бинарник MCP-сервера для MySQL, MariaDB, PostgreSQL и SQLite: запросы только на чтение по умолчанию и маскировка ПДн
Один MCP-сервер для SQLite, SQL Server, PostgreSQL и MySQL: агент читает и меняет данные, правит схему и выгружает CSV и JSON
Официальный MCP-сервер Couchbase: агент смотрит схему, ищет документы и строит SQL++, по умолчанию только чтение
Легкое рабочее место для баз данных с MCP-сервером: агент читает схему, выполняет запросы и разбирает данные в PostgreSQL, MySQL и других
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| football-docs (эта карточка) | нет | не нужна | 226 | |
| Context7 | да | API-ключ | 64 656 | Context7 индексирует документацию библиотек общего назначения, а football-docs специализируется на провайдерах и инструментах футбольных данных. |
| football-match-report | нет | 120 | football-match-report делает отчеты по матчам, а football-docs отдает документацию по форматам данных провайдеров. |
Коротко о README
Индекс документации по 31 провайдеру футбольных данных для агентов: типы событий, координаты, API, сравнение провайдеров и сопоставление идентификаторов.