FPL MCP

Управляйте своей командой Fantasy Premier League с помощью ИИ. Сервер MCP, который позволяет LLM-клиенту вроде Claude читать вашу команду FPL, анализировать игроков и матчи, предлагать трансферы, следить за соперниками в мини-лиге и реально совершать трансферы, назначать капитана и активировать чипы — всё через обычный чат на естественном языке.

⚠️ Неофициальный. Не связан с Премьер-лигой, не одобрен ею и не имеет к ней отношения. Использует публичный API FPL. Работает полностью на вашем компьютере — ваш сессионный токен никогда не покидает вашу машину, и ваш пароль не виден этому инструменту или модели.

Демо

Одно предложение — несколько действий: трансфер, смена капитана и изменение состава — всё выполняется на реальной команде:

«Продать Жуана Педро, купить Хавертца, сделать Холанда капитаном, и вывести Йейтса в стартовый состав вместо Ле Фе»

Related MCP server: FPL MCP Server

Чем это отличается

Большинство FPL-инструментов только читают данные и дают советы, которые вы потом применяете вручную. Этот:

• Реально управляет вашей командой — трансферы, капитан, состав и чипы выполняются по-настоящему.

• Входит в систему, не касаясь вашего пароля — открывается настоящий браузер, вы входите на официальной странице FPL, и захватывается только сессионный токен.

• Следит за вашей мини-лигой — составы соперников публичны, поэтому он вычисляет владение игроками в вашей лиге и сообщает ваше преимущество и угрозы.

• Предлагает трансферы с учётом позиций — три стратегии: максимальные очки, безопасные шаблонные варианты или дифференциалы для подъёма в рейтинге.

Инструменты

Как работает вход (и почему это безопасно)

FPL перешёл на токеновую аутентификацию (PingOne OIDC). Вместо запроса вашего пароля login_to_fpl:

1. Открывает настоящее окно браузера на официальном сайте FPL.

2. Вы самостоятельно входите в систему.

3. Сессионный токен считывается из сетевого трафика и сохраняется локально в token.txt.

Ваш пароль вводится только на странице FPL — он никогда не попадает в этот код или в модель. Никакой обход защиты от ботов не используется; вход выполняет человек. Полное техническое описание см. в docs/FINDINGS.md.

Требования

• Python 3.12+

• uv

• Node.js (только если вы используете MCP Inspector для разработки)

Установка

git clone https://github.com/MoayadAbbara/FPL-MCP.git
cd FPL-MCP
uv sync --extra browser      # includes Playwright for browser login
uv run playwright install chromium

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

Зарегистрируйте сервер в вашем MCP-клиенте. Для Claude Code:

claude mcp add fpl -- uv run --directory /path/to/FPL-MCP python src/server.py

Или добавьте его в конфигурацию MCP вашего клиента (.mcp.json / claude_desktop_config.json):

{
  "mcpServers": {
    "fpl": {
      "command": "uv",
      "args": ["run", "python", "src/server.py"],
      "cwd": "/path/to/FPL-MCP"
    }
  }
}

Перезапустите клиент и просто общайтесь с ним.

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

После подключения используйте обычный язык:

"Sign in to FPL"
"Show my team"
"Any injury news on Arsenal players?"
"Compare Haaland and Gyökeres"
"Suggest transfers — differential mode"
"Analyse my mini-league 123456"
"Transfer out Haaland, bring in João Pedro, and make Watkins captain"

Модель вызывает нужные инструменты и, если что-то меняет команду, сообщает вам, что она сделала.

Архитектура

Каждый уровень знает только о нижележащем:

src/
  tools/    MCP tool surface (thin glue: fetch -> domain -> format -> text)
  format/   raw data -> compact, model-friendly text
  domain/   pure FPL logic (scoring, suggestions, roster maths) — no HTTP, no MCP
  api/      FPL HTTP client
  auth/     token capture (browser) and storage
  server.py entry point

Сырой JSON FPL никогда не попадает в модель; он проходит через domain/, затем format/, так что до модели доходят только релевантные для принятия решений данные.

Разработка

uv run ruff format . && uv run ruff check --fix .   # format + lint
uv run python src/server.py                          # run the server (stdio)

Примечания

• Инструменты, зависящие от сезона (suggest_transfers, analyze_mini_league), лучше всего работают после начала сезона; до первого дедлайна они возвращают понятное сообщение «пока недоступно».

• Управление командой через автоматизацию может нарушать правила FPL. Используйте для своей собственной команды и соблюдайте их.

Лицензия

MIT