Liga Record MCP

MCP-сервер, который предоставляет Claude доступ к моей команде для фэнтези-футбола Liga Record: правила как инструменты, регламент как ресурс и два промпта для решений, которые я принимаю каждый тур.

В основе лежит разделение: детерминированные правила живут в коде, суждения остаются за Claude. Легальность состава, бюджетная арифметика и автоматические замены §11 вычисляются здесь и являются авторитетными. Кого выпускать в старте и кого продавать — это уже рассуждения Claude на основе реальных данных и настоящего регламента.

См. docs/PLANNING.md — там описание дизайна и те неоднозначности правил, которые оставляет эта трактовка регламента.

Установка

python -m venv .venv
.\.venv\Scripts\python.exe -m pip install -e .

Редактируемая установка обязательна — она помещает liga_record_mcp в путь (в проекте используется структура src/) и создаёт лаунчер liga-record-mcp, на который указывает конфиг MCP.

Ваша команда хранится в data/squad.yaml. Скопируйте data/squad.example.yaml и заполните своих 23 игроков — загрузчик при каждом чтении сверяет файл с регламентом и называет, чего не хватает, так что считать вручную не придётся. Укажите LIGA_RECORD_SQUAD на другой файл, чтобы запустить вторую команду.

Related MCP server: wcprediction-mcp

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

.mcp.json в корне репозитория уже объявляет сервер, так что Claude Code подхватит его при открытии проекта — CLI не нужен. Перезапустите Claude Code после установки и подтвердите сервер по запросу.

Путь в .mcp.json абсолютный и зависит от машины. Windows разрешает относительную команду относительно каталога запускающего процесса, а не сервера, поэтому относительный путь не сработает при запуске приложением. Отредактируйте этот путь, если переместите или склонируете репозиторий.

Claude Desktop использует ту же структуру в claude_desktop_config.json:

{
  "mcpServers": {
    "liga-record": {
      "command": "C:\\path\\to\\liga-record-mcp\\.venv\\Scripts\\liga-record-mcp.exe"
    }
  }
}

Затем спросите что-нибудь вроде: «Легален ли мой текущий стартовый состав, и кто выйдет на замену, если Диогу Кошта не сыграет?»

Что он предоставляет

Инструменты — get_squad, get_player, search_squad, validate_selection, simulate_autosubs, check_transfer, project_price, а также два, которые читают живой сайт: search_market (весь пул игроков с процентами владения для поиска дифференциалов) и check_market_transfer (оценивает обмен по реальной котировке, а не по введённой вручную). Каждое чтение несёт временную метку as_of, чтобы Claude мог сказать, насколько свежи данные, а не выдавать сохранённый состав за актуальный.

Живой клиент только для чтения по замыслу. Сайт также предоставляет конечные точки покупки, продажи и пересмотра контрактов — их контракты известны, — но они намеренно не реализованы. Подтверждение трансфера остаётся за человеком, кликающим на сайте Record.

Ресурсы — ligarecord://regulamento (генерируется из тех же констант, которые применяют правила, так что не может разойтись с кодом) и ligarecord://squad.

Промпты — pick_starting_xi, plan_transfers.

Тесты

./.venv/Scripts/python.exe -m pytest -q

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

Статус

Шаги 1–3 готовы: движок правил, слой источника данных с вручную поддерживаемым YAML-составом и MCP-сервер.

Шаг 4 выполнен наполовину, и та половина, которая важнее, — это то, что уже вышло. playersearch.ashx возвращает чистый JSON по всему рынку из 498 игроков и не требует аутентификации — проверено запросом без куки, — так что проблема с токеном сессии, которую план считал главным риском шага 4, для рыночных данных просто не возникает.

Для чтения состава конкретной команды по-прежнему нужен вход в систему, поэтому data/squad.yaml остаётся в ручном режиме. Это оставшаяся часть.