LiveFPL MCP Server

Сервер MCP, который предоставляет прогнозы повышения/понижения цены игроков Fantasy Premier League с LiveFPL.

Данные берутся с публичного JSON-хоста LiveFPL (https://livefpl.us) — те же конечные точки, которые загружает сам сайт. Не требуется ни аккаунта, ни API-ключа, ни аутентификации.

Источник данных (реверс-инжиниринг)

Страница https://www.livefpl.net/prices загружает свою таблицу прогнозов цен из:

Страница лиги — это серверный HTML (без JSON API) — живые результаты игровой недели встроены в страницу, поэтому сервер загружает и парсит этот HTML.

Поля prices.json

Ключ — идентификатор игрока. Для каждого игрока:

• progress — текущий прогресс к изменению цены, как доля порога. Положительный ⇒ рост, отрицательный ⇒ падение. +1.0 означает, что ожидается повышение; -1.0 — что ожидается понижение. На сайте отображается в столбце «Сейчас».

• progress_tonight — прогнозируемый прогресс к следующему моменту изменения. Отображается в столбце «Прогноз». Именно по этому значению сортируются инструменты.

• per_hour — скорость изменения прогресса в час (столбец «В час»).

• cost, name, team, type (GK/DEF/MID/FW).

Инструменты

Граф тренда трансферов строится на клиенте из top_transfers.json (так же, как страница LiveFPL строит свой пузырьковый график): чистый результат по игроку = трансферы в − трансферы из, размер узла = общий объём, рёбра = пары трансферов (из → в).

Каждый результат по игроку включает progress_now_pct, prediction_pct, per_hour_pct, direction (rise/fall/stable) и predicted_new_cost.

Установка

cd livefpl-mcp
uv sync

Запуск

uv run livefpl-mcp

Сервер общается по MCP через stdio.

Конфигурация Claude Desktop / MCP-клиента

Добавьте в конфигурацию вашего MCP-клиента (например, claude_desktop_config.json):

{
  "mcpServers": {
    "livefpl": {
      "command": "uv",
      "args": ["--directory", "C:\\path-to-mcp\\livefpl-mcp", "run", "livefpl-mcp"]
    }
  }
}

Примеры запросов

• «Какие защитники FPL скоро подорожают?»

• «Покажи топ-10 игроков, которые упадут в цене сегодня вечером.»

• «Каков прогноз цены для Холанда?»

• «Какие трансферы сейчас самые популярные?»

• «Покажи живые результаты для лиги 230412.»

• «Кто сейчас выигрывает игровую неделю в моей лиге 230412?»

Примечания

• Прогнозы принадлежат LiveFPL, а не официальному алгоритму FPL; точность лучше всего на одиночных игровых неделях (LiveFPL отмечает, что правила двойных игровых недель менее определённы).

• Данные загружаются в реальном времени при каждом вызове инструмента.

Лицензия

MIT