sisrun-mcp

🇧🇷 Португальская версия ниже

Неофициальный MCP сервер, который открывает ваш тренировочный план из SisRUN (appsisrun.com.br) для ИИ-ассистентов, таких как Claude, чтобы вы могли спросить «что мой тренер прописал на этой неделе?» и получить структурированный ответ.

У SisRUN нет публичного API, поэтому сервер читает те же веб-страницы, которые вы видите в браузере, с вашими собственными учётными данными и разбирает их в структурированные данные о тренировках. Он работает только на чтение: никогда ничего не записывает в SisRUN.

Инструменты

Каждая строка тренировки содержит: дату, статус (Proposto = предписанная, Feito = выполненная, Feito Avulso = импортированная автоматически, не предписанная), вид нагрузки, предписанную дистанцию, диапазоны темпа и ЧСС, структурированную сессию тренера (разминка, повторы, восстановление), пометку тренера, а также то, что SisRUN засчитал как выполненное (дату, дистанцию, время, средний ЧСС, ккал; SisRUN автоматически импортирует ваши активности из Garmin/Strava).

planned_km против distance_km: собственное поле Distância в SisRUN пусто для каждой интервалной, холмистой и привязанной по времени сессии, а в интервальные дни оно учитывает только повторы. Суммирование этого столбца занижает реальную предписанную нагрузку примерно на ~35% (на той же ошибке построена собственная панель «Evolução Semanal» в SisRUN). planned_km берёт честное число из структурированной сессии тренера, раскрывая блоки Repetir Nx; planned_km_is_est: "yes" помечает строки, где шаг, заданный по времени, пришлось пересчитывать по предполагаемому темпу.

Related MCP server: Strava MCP Server

Установка

uvx sisrun-mcp            # zero-install run from PyPI
# or
pipx install sisrun-mcp
# or straight from GitHub
uvx --from git+https://github.com/cdutr/sisrun-mcp sisrun-mcp

Учётные данные

Ваш собственный логин в SisRN (тот, который выдал вам тренер). Либо через переменные окружения:

export SISRUN_EMAIL=you@example.com
export SISRUN_PASSWORD=yourpassword

либо через файл учётных данных:

mkdir -p ~/.sisrun
cat > ~/.sisrun/credentials <<'EOF'
email=you@example.com
password=yourpassword
EOF
chmod 600 ~/.sisrun/credentials

⚠️ Пароль хранится в открытом виде. SisRN не предлагает ни токена, ни OAuth-механизма, поэтому лучшего варианта нет. Держите файл с правами chmod 600 и никогда не публикуйте его в системе контроля версий.

Конфигурация Claude Desktop / Claude Code

{
  "mcpServers": {
    "sisrun": {
      "command": "uvx",
      "args": ["sisrun-mcp"]
    }
  }
}

Отладка

Загрузите и выведите свою текущую неделю без MCP-клиента:

python -m sisrun_mcp selftest

Если в результате появится warning об отсутствующих панелях с деталями, значит, механизм накопления состояния формы в JSF регрессировал. Пожалуйста, откройте issue с этим выводом — в нём нет учётных данных.

Как это работает (для любознательных)

SisRUN основан на JSF + PrimeFaces 8.0. Каждый запрос несёт токен javax.faces.ViewState, а все идентификаторы виджетов генерируются сервером: они меняются при любом передеплое, поэтому здесь ничего не захардкожено. Кнопки ищутся по стабильным, написанным человеком атрибутам title, а ViewState заново читается из каждого ответа. Нетривиальный момент: панели деталей дня — это аккордеоны, которые сервер рендерит только тогда, когда в запросе передано их развёрнутое состояние, накопленное по ходу переходов между страницами, вместе с javax.faces.partialList.execute=@all. Без этого вы молча получите сводные строки без тренировочных предписание. Подробнее см. комментарии в client.py.

Клиент намеренно вежлив: одна неделя на запрос, с интервалом 0,6 с, и HTML недели кешируется на процесс.

Вклад в развитие

Баг-репорты, предложения по функциям и пул-реквесты приветствуются на английском или португальском. См. CONTRIBUTING.md.

Статус и отказ от ответственности

• Неофициальный. Не аффилирован с SisRUN, не одобрен и не поддерживается им. Может перестать работать при изменении сайта SisRUN; приветствуются issues и PR.

• Только ваши данные. Он обращается к вашему собственному учётной записи тренировок с вашими собственные учетными данными, используя ту же переносиомность данных, которую гарантирует вам LGPD. Не используйте его против чужих учётных записей и соблюдайте условия обслуживания SisRUN.

• Протестирован на реальных аккаунтах с 2026-07. Python ≥ 3.10, единственный dependency (mcp).

Em português (pt-BR)

На португальском (pt-BR)

Неофициальный MCP сервер, который открывает ваш тренировочный план SisRUN (appsisrun.com.br) для ИИ-ассистентов, таких как Claude. С ним вы сможете спросить «что тренер прописал на этой неделе?» и получить структурированные тренировки: статус (Proposto / Feito / Feito Avulso), дистанцию, диапазоны темпа и пульса, структуру сессии (разминка, повторы, восстановление), пометку тренера и то, что SisRUN сопоставил как выполненное (SisRN); SisRun автоматически импортирует ваши активности Garmin/Strava).

У SisRUN нет публичного API, поэтому сервер читает те же страницы, которые вы видите в браузере, с вашими собственными учётными. Он только читает; никогда ничего не пишет в SisRun.

Инструменты: document.currentTickerWeek() (текущая неделя), get_week(date) (неделя даты), get_upcoming(weeks_ahead) (предложенные тренировки с сегодняшнего дня).

Установка:

uvx sisrun-mcp
# ou
pipx install sisrun-mcp

Учётные данные: ваш собственный логин в SisRUN, через переменные окружения (SISRUN_EMAIL / SISRUN_PASSWORD) или через файл ~/.sisrun/credentials:

email=voce@exemplo.com
password=suasenha

chmod 600 ~/.sisrun/credentials

⚠️ Пароль хранится в открытом виде теksi. SisRUN не предоставляет ни токена, ни OAuth, поэтому лучшего варианта не существует. Храните файл с chmod 600 и никогда не коммитьте его.

О planned_km: поле Distância в SisRUN пустует в каждой интервальной, подъёмной или привязанной по времени тренировке, а в интервальные дни оно учитывает только повторы. Суммирование всех значений занижает реальную предписание примерно на ~35% (панель «Evolução Semanal» самого SisRUN повторяет этот баг). planned_km берёт честное число из структурированной сессии, развоRAчив блоки Repetir Nx.

Предупреждения: проект не аффилирован с SisRUN, не одобрен им и не поддерживается им. Может сломаться при изменении сайта — приветствуются и PR. Он обращается только к вашим собственным данным с вашими учётными данными, а это то же перемещение данных, которое обеспечивает вып LGPD. Не применяйте его против чужих учётных записей и соблюдайте условия использования SisRUN.

Для отладки без MCP-клиента: запустите python -m sisrun_mcp selftest, чтобы вывести текущую неделю в формате JSON.

Лицензия

MIT