Skip to main content
Glama
jjaquezito

Football Live MCP

by jjaquezito

Football Live MCP

Удалённый MCP-сервер, который предоставляет живые футбольные данные из API-Football по HTTP и реализует JSON-RPC 2.0 напрямую, без использования какого-либо MCP SDK.

Компаньон локального Football Intelligence MCP-сервера: этот сервер работает с текущим сезоном, а локальный — с исторической базой данных (2010–2025), хранящейся в PostgreSQL.

Протокол

Транспорт: HTTP. Один эндпоинт, одно сообщение JSON-RPC на запрос.

Эндпоинт

Назначение

GET /

Проверка работоспособности. Возвращает имя сервера, версию и количество инструментов.

POST /mcp

Сообщения JSON-RPC 2.0. Уведомления возвращают 202 без тела.

Реализованные методы: initialize, notifications/initialized, ping, tools/list, tools/call.

Версия протокола: 2025-06-18.

Related MCP server: football-api-mcp

Инструменты

Инструмент

Аргументы

Возвращает

get_upcoming_matches

league_id, days (по умолчанию 7)

Запланированные матчи в указанном окне

get_recent_results

league_id, days (по умолчанию 7)

Завершённые матчи со счётом

get_current_standings

league_id

Актуальная турнирная таблица

get_current_injuries

team_id

Травмированные/дисквалифицированные игроки

get_live_matches

—

Матчи, идущие прямо сейчас

search_team_live

query

Идентификаторы команд из API-Football

Идентификаторы лиг: 39 Premier League, 140 La Liga, 135 Serie A, 78 Bundesliga, 61 Ligue 1, 94 Primeira Liga, 2 UEFA Champions League.

Локальный запуск

pip install -r requirements.txt
export API_FOOTBALL_KEY=your_key_here
python server.py                    # listens on :8080

Проверка:

curl http://localhost:8080/

curl -X POST http://localhost:8080/mcp \
  -H 'content-type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Развёртывание на Render

  1. Отправьте этот каталог в репозиторий GitHub.

  2. В Render создайте новый веб-сервис и подключите этот репозиторий.

  3. Render читает render.yaml; подтвердите runtime Python и бесплатный тариф.

  4. Добавьте переменную окружения API_FOOTBALL_KEY с вашим ключом API-Football.

  5. Выполните деплой. Публичный эндпоинт будет https://<service>.onrender.com/mcp.

Бесплатный тариф переводит сервис в спящий режим после бездействия, поэтому первый запрос после паузы занимает около 50 секунд. Перед живой демонстрацией выполните один запрос GET /, чтобы разбудить сервис.

Использование из MCP-хоста

Добавьте запись с полем url в конфигурацию хоста:

{
  "mcpServers": {
    "football_live": { "url": "https://<service>.onrender.com/mcp" }
  }
}

Related MCP Connectors

Related MCP Servers

  • F
    license
    Not graded
    quality
    D
    maintenance
    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.
    7
    -
  • A
    license
    Not graded
    quality
    D
    maintenance
    MCP server for football-data.org API providing access to football data like standings, matches, teams, and scorers.
    MIT
  • F
    license
    A
    quality
    D
    maintenance
    Provides live football data through MCP tools, enabling users to fetch today's matches and top scorers for competitions like the Premier League or World Cup.
    2
    -
  • A
    license
    A
    quality
    D
    maintenance
    Enables MCP clients to access live football data from FotMob, including match stats, team form, injuries, and player workload, without making predictions.
    10
    1
    MIT