sisrun-mcp

🇧🇷 Versión en portugués a continuación

Servidor MCP no oficial que expone tu plan de entrenamiento de SisRUN (appsisrun.com.br) a asistentes de IA como Claude, para que puedas preguntar "¿qué me prescribió mi entrenador esta semana?" y obtener una respuesta estructurada.

SisRUN no tiene una API pública, por lo que este servidor lee las mismas páginas web que ves en tu navegador, con tus propias credenciales, y las convierte en datos estructurados de entrenamiento. Es de solo lectura: nunca escribe nada en SisRUN.

Herramientas

Cada fila de entrenamiento incluye: fecha, estado (Proposto = prescrito, Feito = realizado, Feito Avulso = auto-importado, no prescrito), modalidad, distancia prescrita, rangos de ritmo y FC, la sesión estructurada del entrenador (calentamiento, repeticiones, recuperaciones), la nota del entrenador y lo que SisRUN asoció como entregado (fecha, distancia, tiempo, FC media, kcal; SisRUN autoimporta tus actividades de Garmin/Strava).

planned_km vs distance_km: El campo Distância del propio SisRUN está vacío en todo entrenamiento por intervalos, por cuestas o por tiempo, y en los días de intervalos solo cuenta las repeticiones. Al sumar esa columna se subestima la prescripción real en ~35% (el panel "Evolução Semanal" del propio SisRUN tiene el mismo error). planned_km deriva el número honesto de la sesión estructurada del entrenador, expandiendo los bloques Repetir Nx; planned_km_is_est: "yes" marca las filas en las que un paso cronometrado tuvo que convertirse en un ritmo supuesto.

Related MCP server: Strava MCP Server

Instalación

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

Credenciales

Tu propio inicio de sesión de SisRUN (el que te dio tu entrenador). O las variables de entorno:

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

o un archivo de credenciales:

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

⚠️ La contraseña se almacena en texto plano. SisRUN no ofrece un mecanismo de token ni OAuth, así que no hay una opción mejor. Mantén el archivo con chmod 600 y nunca lo subas.

Configuración de Claude Desktop / Claude Code

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

Depuración

Obtén e imprime tu semana actual sin ningún cliente MCP:

python -m sisrun_mcp selftest

Si algún resultado contiene un warning sobre paneles de detalle faltantes, la acumulación del estado de formulario JSF ha sufrido una regresión. Abre un issue con la salida (no contiene credenciales).

Cómo funciona (para los curiosos)

SisRUN es JSF + PrimeFaces 8.0. Cada solicitud lleva un token javax.faces.ViewState, y todos los ids de los widgets se generan en el servidor: cambian en cualquier redespliegue, así que nada aquí se codifica de forma fija. Los botones se buscan por sus estables atributos title creados por humanos, y el ViewState se vuelve a leer de cada respuesta. La parte no evidente es que los paneles de detalle del día son acordeones que el servidor solo renderiza cuando la solicitud lleva su estado desplegado, acumulado de una navegación a otra, junto con javax.faces.partial.execute=@all. Sin eso, se obtienen filas de resumen sin prescripciones. Ver los comentarios en client.py.

El cliente es deliberadamente respetuoso: una semana por solicitud, espaciadas 0,6 s, y el HTML de la semana se guarda en caché por proceso.

Contribuir

Aceptamos informes de errores, sugerencias de funciones y PRs, en inglés o portugués. Ver CONTRIBUTING.md.

Estado y descargos

• No oficial. No está afiliado a SisRUN, ni respaldado ni reconocido por él. Puede romperse cuando SisRUN cambie su página web; issues y PRs son bienvenidos.

• Solo tus datos. Esto accede a tu propio plan de entrenamiento con tus propias credenciales, que la misma portabilidad de datos que la LGPD te otorga. No lo uses con cuentas que no sean tuyas y respeta los términos de servicio de SisRUN.

• Probado con cuentas reales desde 2026-07. Python ≥ 3.10, una sola dependencia (mcp).

En portugués (pr-BR)

Servidor MCP no oficial que expone tu planilla de entrenamiento de SisRUN (appsisrun.com.br) a asistentes de IA como Claude. Con él preguntas "¿qué recetó el entrenador esta semana?" y recibes los entrenamientos estructurados: estado (Proposto / Feito / Feito Avulso), distancia, rangos de ritmo y de FC, la estructura de la sesión (calentamiento, tiros, recuperaciones), la nota del entrenador y lo que SisRUN asoció como realizado (SisRUN importa tus actividades del Garmin/Strava automáticamente).

SisRUN no tiene una API pública, así que el servidor lee las mismas páginas que ves en el navegador, con tus propias credenciales. Es de solo lectura: nunca escribe nada en SisRUN.

Herramientas: get_current_week() (semana actual), get_week(date) (semana de una fecha), get_upcoming(weeks_ahead) (entrenamientos propuestos de aquí en adelante).

Instalación:

uvx sisrun-mcp
# ou
pipx install sisrun-mcp

Credenciales: tu propio login de SisRUN, por variables de entorno (SISRUN_EMAIL / SISRUN_PASSWORD) o por el archivo ~/.sisrun/credentials:

email=voce@exemplo.com
password=suasenha

chmod 600 ~/.sisrun/credentials

⚠️ La contraseña está en texto plano. SisRUN no ofrece OAuth ni token, así que no hay mejor opción. Mantén el archivo con chmod 600 y nunca lo subas a un repositorio.

Sobre planned_km: el campo distância del propio SisRUN está vacío en todo entrenamiento intervalado, entre colinas o por tiempo, y en los días de subida solo cuenta las repeticiones. Sumar esa columna subestima la prescripción real en ~35% (el panel "Evolução Semanal" del propio SisRUN tiene el mismo error). planned_km obtiene el número honesto a partir de la sesión estructurada del entrenador, expandiendo los bloques Repetir Nx.

Avisos: proyecto no afiliado, no endosado y no respaldado por SisRUN. Puede romperse cuando cambie la página (issues y PRs son bienvenidos). Accede solo a tus propios datos, con tus propias credenciales, la misma portabilidad que te garantiza la LGPD. No lo uses con cuentas ajenas y respeta los términos de uso de SisRUN.

Para depurar sin cliente MCP: python -m sisrun_mcp selftest imprime la semana actual en JSON.

Licencia

MIT