Football Live MCP

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

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

Протокол

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

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

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

Инструменты

Идентификаторы лиг: 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" }
  }
}