alpha-progression-mcp

Alpha Progression MCP

Claude（または任意のMCPクライアント）を、ジムのデータとトレーニングを分析し、プランを調整できる**Alpha Progression**に接続します。

• 「各筋肉について、週あたりのセット数は十分ですか？」
• 「過去3か月で停滞したリフト種目はどれですか？」
• 「Day 2にハムストリングの種目を追加して、ベンチプレスを4 × 6にしてください。」

非公式プロジェクトであり、Alpha Progressionとは提携していません。ご自身のアカウントでのみご利用ください。

セットアップ

uvが必要です。

1. 一度ログインします。メールアドレスとパスワードは保存されず、アクセストークンのみが保存されます（~/.config/alpha-progression-mcp/token.json）。

   uvx alpha-progression-mcp login
   

2. Claude Codeに追加します：

   claude mcp add alpha-progression -- uvx alpha-progression-mcp
   

   その他のクライアント：

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

3. クライアントを再起動します。

ツール

ツール	戻り値
get_weekly_training	筋肉ごとの週あたりのセット数とトレーニング日数
get_progress	筋肉群ごとの、向上中または停滞中のリフト種目（e1RM）
get_sessions / get_session	最近のワークアウト／1回のワークアウトの全セット
get_exercise_history	1種目の経時的な履歴
find_exercises	名前または筋肉による種目の検索
get_plans	セット数とレップ数の目標を含む現在のプラン
get_measurements	体重などの測定値
get_document	任意の単一レコード
set_plan_targets / add_plan_exercise / swap_plan_exercise / remove_plan_exercise	プランの変更

プランの編集では、1回の呼び出しにつき対象を1つ変更します。まず変更内容をプレビューし、承認後にのみ保存します。ワークアウト履歴には一切手を加えません。変更の前にはプランのバックアップが~/.config/alpha-progression-mcp/backups/に保存されます。また、アプリの無料版で可能な変更のみを行います（RIR目標、ディロード、ピリオダイゼーションは対象外です）。変更は同期後にアプリに反映されます。編集を無効にするには、ALPHA_PROGRESSION_READ_ONLY=1を設定します。

名前は部分一致で指定できます（「bench press」、「day 2」など）。曖昧な場合は候補が表示されます。

**指標：**ワーキングセットには、ウォームアップ（最初の高重量セット前の軽いセット）とストレッチは含まれません。筋肉ごとのセット数は、対象筋に1、主な補助筋に0.5としてカウントします（分数カウント、Pelland et al. 2024）。e1RMはEpley式（重量 × (1 + レップ数 / 30)）で算出し、レップ数は最大15回までです。

トラブルシューティング

• **「Not logged in」／「login has expired」：**ログインコマンドをもう一度実行します。
• **「Too many login attempts」：**数分待ちます。パスワードを間違えると、Alpha Progressionはログインをロックします。
• 接続の確認： uvx alpha-progression-mcp status
• ログアウト： ~/.config/alpha-progression-mcp/token.jsonを削除します。

開発

uv sync && uv run pytest && uv run ruff check . && uv run ruff format .

同期プロトコルについてはdocs/api.mdをご覧ください。MITライセンス。