sisrun-mcp

🇧🇷 Portugiesische Version unten

Inoffizieller MCP-Server, der deinen SisRUN-Trainingsplan (appsisrun.com.br) KI-Assistenten wie Claude bereitstellt, sodass du fragen kannst: „Was hat mir mein Trainer diese Woche verordnet?“ – und eine strukturierte Antwort erhältst.

SisRUN hat keine öffentliche API. Der Server liest also dieselben Webseiten, die du im Browser siehst, mit deinen eigenen Zugangsdaten, und parst sie in strukturierte Trainingsdaten. Er ist rein lesend: Er schreibt nie etwas in SisRUN.

Werkzeuge

Jede Trainingszeile enthält: Datum, Status (Proposto = verordnet, Feito = erledigt, Feito Avulso = automatisch importiert, nicht verordnet), Trainingsart, verordnete Distanz, Tempo- und Herzfrequenzbereiche, die strukturierte Einheit des Trainers (Aufwärmen, Wiederholungen, Erholungsabschnitte), die Notiz des Trainers und das, was SisRUN als erledigt zugeordnet hat (Datum, Distanz, Zeit, durchschnittliche Herzfrequenz, kcal; SisRUN importiert deine Garmin-/Strava-Aktivitäten automatisch).

planned_km vs. distance_km: SisRUNs eigenes Feld Distância ist bei Intervall-, Hügel- und zeitbasierten Einheiten immer leer und zählt an Intervalltagen nur die Wiederholungen. Wenn man diese Spalte summiert, unterschätzt das die tatsächliche Verordnung um ~35 % (das Panel „Evolução Semanal“ von SisRUN hat denselben Fehler). planned_km leitet den realistischen Wert aus der strukturierten Einheit des Trainers ab und expandiert dabei Repetir Nx-Blöcke; planned_km_is_est: "yes" kennzeichnet Zeilen, in denen ein zeitbasierter Schritt mit einem angenommenen Tempo umgerechnet werden musste.

Related MCP server: Strava MCP Server

Installation

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

Zugangsdaten

Dein eigener SisRUN-Login (der, den dir dein Trainer gegeben hat). Entweder als Umgebungsvariablen:

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

oder als Zugangsdaten-Datei:

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

⚠️ Das Passwort wird im Klartext gespeichert. SisRUN bietet keinen Token- oder OAuth-Mechanismus, daher gibt es keine bessere Möglichkeit. Setze die Datei auf chmod 600 und committe sie niemals.

Claude Desktop / Claude Code-Konfiguration

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

Debugging

Ruf deine aktuelle Woche ohne Verbindung ab und gib sie aus:

python -m sisrun_mcp selftest

Wenn ein Ergebnis jemals einen warning wegen fehlender Detail-Panels enthält, ist die JSF-Formularzustands-Akkumulation in Regression. Bitte schaff ein Issue mit der Ausgabe (sie enthält keine Zugangsdaten).

So funktioniert es (für Neugierige)

SisRUN ist JSF + PrimeFaces 8.0. Jede Anfrage trägt ein javax.faces.ViewState-Token, und alle Widget-IDs werden serverseitig generiert: Sie ändern sich bei jedem Deployment, deshalb werden hier keine festgeschrieben. Schaltflächen werden über ihre stabilen, von Menschen verfassten title-Attribute gefunden, und der ViewState wird bei jeder Antwort neu gelesen. The wenig bekannte Teil: Die Detail-Panels pro Tag sind Akkordeons, die der Server nur aktualisiert, wenn die Anfrage ihren expandiertenontain – über mehrere Navigationsschritte hinweg angesammelt – zusammen mit javax.faces.partial.execute=@all. Sonst erhältst du stillschweigend nur Zusammenfassungszeilen ohne Verordnungen. Näheres siehe in den Kommentaren in client.py.

Der Client ist bewusst manierenhaft: eine Woche pro Anfrage, mit 0,6 Sekunden Abstand, und das Wochen-HTML wird pro Prozessende zwischengespeichert.

Beiträge

Bug-Meldungen, Feature-Wünsche und PRs sind willkommen – auf Englisch oder Portugiesisch. Siehe CONTRIBUTING.md.

Status & Hinweise

• Inoffiziell. Weder mit SisRUN verbunden, noch von SisRUN befürwortet oder unterstützt. Wenn SisRUN seine Seite ändert, kann der Server ausfallen; Issues und PRs sind willkommen.

• Nur deine eigenen Daten. Diese Erweiterung greift nur mit deinen eigenen Zugangsdaten auf deinen eigenen Trainingsplan zu – dieselbe Datenportabilität, die dir die LGPD garantiert. Verwende sie nicht für Konten, die nicht dir gehören, und beachte die Nutzungsbedingungen von SisRUN.

• Getestet mit echten Konten seit 2026-07. Python ≥ 3.10, nur eine einzige Abhängigkeit (mcp).

Em português (pt-BR)

Servidor MCP não oficial que expõe sua planilha de treinos do SisRUN (appsisrun.com.br) para assistentes de IA como Claude. Com ele você pergunta „O que o treinador prescreveu essa semana?“ e recebe os treinos estruturados: status (Proposto / Feito / Feito Avulso), distância, faixas de ritmo e FC, a estrutura da sessão (aquecimento, tiros, recuperações), a observação do treinador e o que o SisISO associou como realizado (o SisRUN importa suas atividades na Garmin/Strava automaticamente).

O SisRUN não tem API pública, então o servidor lê as mesmas páginas que você vê no navegador, com as suas próprias credenciais. É somente leitura: nunca escreve nada no SisRUN.

Ferramentas: ger_current_week() (semana atual), get_week(date) (semana de uma data), get_upcoming(weeks_ahead) (treinos propostos daqui pra frente).

Instalação:

uvx sisrun-mcp
# ou
pipx install sisrun-mcp

Credenciais: seu próprio login do SisRUN, por relações de ambiente (SISRUN_EMAIL / SISRUN_PASSWORD) ou pelo arquivo ~/.sisrun/credentials:

email=voce@exemplo.com
password=suasenha

chmod 600 ~/.sisrun/credentials

⚠️ A senha fica em texto puro. O SisRUN não oferece token nem OAuth, então não existe opção melhor. Mantenha o arquivo com chmod 600 e nunca faça commit dele.

Sobre planned_km: o campo Distância do próprio SisRUN fica vazio em todo treino intervalado, de subida ou no tempo, e em dias de tiro código só as repetições. Somar essa coluna Strategie, subestima a prescrição real perto de ~35 % (o painel „Evolução Semanal“ do próprio SisRU es hat denselben Bug). O planned_km leitet den wahren Wert aus der strukturierten Trainneinheit de Trainers ab und expandível os blocos Repetir Nx.

Avisos: não afiliado, não endossado e não suportado pelo SisRUN. Pode que causar a quebra quando o site mudar (issues e PRs são bem-vindos). Ele acessa apenas os seus dados, com as suas credenciais, o mesmo nível de portabilidade de dados que a LGPD garante a você. Não use against contagens não não sua culpa.

Para depurar seu cliente MCP nenhum: python -m sisrun_mcp selftest imprime a semana atual em formato JSON.

Lizenz

MIT