SisRUN Training Plan

sisrun-mcp

🇧🇷 ポルトガル語版はこちら

Claude などの AI アシスタントから「今週、コーチは何を指示しましたか？」と質問し、構造化された回答を得られるよう、あなたのSisRUN（appsisrun.com.br）のトレーニングプランを公開する、非公式のMCPサーバーです。

SisRUN には公開 API がないため、ブラウザーで見るものと同じウェブページをあなた自身の認証情報で読み取り、構造化されたワークアウトデータに解析します。読み取り専用であり、SisRUN に何かを書き込むことはありません。

ツール

ツール	返される内容
get_current_week()	今週のすべてのワークアウト行
get_week(date)	ISO 日付（YYYY-MM-DD）を含む週
get_upcoming(weeks_ahead=1)	今日以降に予定されている、未完了のワークアウト

各ワークアウト行には、日付、ステータス（Proposto＝予定、Feito＝完了、Feito Avulso＝予定外で自動インポート）、種目、予定距離、ペースと心拍数の範囲、コーチが構造化したセッション（ウォームアップ、反復、リカバリー）、コーチのメモ、そして SisRUN が実施済みとして照合した内容（日付、距離、時間、平均心拍数、kcal）が含まれます。SisRUN は Garmin／Strava のアクティビティを自動インポートします。

planned_km と distance_km の違い： SisRUN 独自の Distância フィールドは、インターバル、坂道、時間ベースのセッションではすべて空欄です。また、インターバルの日には反復分だけを集計します。この列を合計すると、実際の予定距離が約 35% 過少になります（SisRUN 独自の「Evolução Semanal」パネルにも同じ不具合があります）。planned_km はコーチが構造化したセッションから正確な数値を算出し、Repetir Nx ブロックを展開します。planned_km_is_est: "yes" は、時間ベースのステップを想定ペースで距離に換算した行を示します。

インストール

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

認証情報

コーチから教わった、あなた自身の SisRUN ログイン情報を使用します。環境変数を使う場合：

export [email protected]
export SISRUN_PASSWORD=yourpassword

または認証情報ファイルを使用します：

mkdir -p ~/.sisrun
cat > ~/.sisrun/credentials <<'EOF'
[email protected]
password=yourpassword
EOF
chmod 600 ~/.sisrun/credentials

⚠️ パスワードは平文で保存されます。 SisRUN にはトークンや 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 トークンが含まれ、ウィジェット ID はすべてサーバー側で生成されます。再デプロイのたびに変わるため、この実装では ID をハードコードしていません。ボタンは、安定した人が設定した title 属性を使って特定し、すべてのレスポンスから ViewState を再読み込みします。分かりにくいポイントは、日ごとの詳細パネルがアコーディオン形式で、リクエストに展開状態を含めた場合にのみサーバーがレンダリングすることです。この状態は画面遷移をまたいで蓄積する必要があり、さらに javax.faces.partial.execute=@all も必要です。これがないと、処方内容のない概要行が何事もなく返されます。client.py のコメントを参照してください。

クライアントは負荷を抑えるよう設計されています。1 リクエストにつき 1 週間分を取得し、0.6 秒間隔を空け、週ごとの HTML はプロセス内でキャッシュします。

コントリビュート

バグ報告、機能の提案、PR を歓迎します。英語またはポルトガル語でお寄せください。CONTRIBUTING.md をご覧ください。

ステータスと免責事項

• 非公式です。 SisRUN との提携、承認、サポートはありません。SisRUN のサイトが変更されると動作しなくなる可能性があります。issue と PR を歓迎します。
• あなた自身のデータのみを使用してください。 あなた自身の認証情報で、あなた自身のトレーニングプランにアクセスします。これは LGPD が認めるデータポータビリティと同じものです。自分以外のアカウントに対して使用せず、SisRUN の利用規約を遵守してください。
• 2026-07 以降、実際のアカウントでテスト済みです。Python ≥ 3.10、依存関係は 1 つ（mcp）です。

ポルトガル語（pt-BR）

MCP の非公式サーバーです。SisRUN（appsisrun.com.br）のトレーニングシートを、Claude などの AI アシスタントに公開します。「今週、コーチは何を指示した？」と尋ねると、ステータス（提案済み／実施済み／予定外で実施済み）、距離、ペースと心拍数の範囲、セッションの構成（ウォームアップ、インターバル、回復）、コーチのコメント、SisRUN が実施済みとして関連付けた内容を構造化して取得できます（SisRUN は Garmin／Strava のアクティビティを自動的にインポートします）。

SisRUN には公開 API がないため、このサーバーはご自身の認証情報を使って、ブラウザーで表示されるページと同じページを読み取ります。読み取り専用で、SisRUN に書き込むことはありません。

ツール： get_current_week()（今週）、get_week(date)（指定日の週）、get_upcoming(weeks_ahead)（今後の提案済みトレーニング）。

インストール：

uvx sisrun-mcp
# ou
pipx install sisrun-mcp

認証情報： ご自身の SisRUN ログイン情報を、環境変数（SISRUN_EMAIL／SISRUN_PASSWORD）または ~/.sisrun/credentials ファイルで指定します。

[email protected]
password=suasenha

chmod 600 ~/.sisrun/credentials

⚠️ パスワードは平文で保存されます。 SisRUN はトークンも OAuth も提供していないため、これより良い方法はありません。ファイルの権限を chmod 600 に設定し、絶対にコミットしないでください。

planned_km について： SisRUN の「距離」フィールドは、インターバル、坂道、時間指定のトレーニングでは常に空欄で、インターバルの日には反復分しかカウントされません。この列を合計すると、実際に指示された距離を約 35%過小評価します（SisRUN 自身の「週間推移」ダッシュボードにも同じバグがあります）。planned_km は、コーチが構成したセッションから正確な距離を算出し、Nx 繰り返しブロックを展開します。

注意事項： SisRUN と提携、推奨、サポート関係にないプロジェクトです。サイトの変更により動作しなくなることがあります（issue や PR は歓迎します）。ご自身の認証情報を使って、ご自身のデータのみにアクセスします。これは LGPD が保証するデータポータビリティと同じです。ご自身以外のアカウントに対して使用せず、SisRUN の利用規約を遵守してください。

MCP クライアントを使わずにデバッグするには、python -m sisrun_mcp selftest を実行すると、今週の内容が JSON 形式で出力されます。

ライセンス

MIT