Alpha Progression Mcp

io.github.dorian-K由 GitHub 帳號 dorian-K 發布v0.1.1更新於 Oct 29, 2026

Analyse your Alpha Progression gym training and adjust your plan.

已驗證STDIO僅桌面位置與生活資料與分析

概覽

AI 產生的概覽

非官方 MCP 伺服器，把助理連接到你的 Alpha Progression 健身資料，用來分析訓練量、進度與課表，並做有針對性的課表調整。

可以做什麼
  • 讀取每週訓練量：各肌群的組數與訓練天數
  • 檢視進度：依肌群列出進步或停滯的動作，以及單一動作的歷史趨勢
  • 查看訓練紀錄：近期訓練、單次訓練的每一組，以及體重等身體測量
  • 依名稱或肌群尋找動作，並讀取任意單筆紀錄
  • 讀取目前課表及其組數與次數目標
  • 編輯課表：設定目標，每次呼叫新增、替換或移除一個動作，先預覽並備份
適用情境
適合在 Alpha Progression 記錄訓練、並希望助理回答每週各肌群組數、停滯動作或動作歷史等問題，或對課表做小幅且經確認的修改時使用。
執行需求
以 Python 套件形式透過 uv/uvx 在本機執行。需用 Alpha Progression 電子郵件與密碼完成一次登入，存取權杖會存在本機設定檔中。未宣告環境變數或標頭；可選擇以 ALPHA_PROGRESSION_READ_ONLY=1 關閉編輯功能。
安裝前請注意
非官方專案，與 Alpha Progression 無關聯，僅限用於自己的帳號。登入憑證需輸入一次，存取權杖會存於磁碟。課表編輯會寫入你的帳號：每次呼叫只改一處，先預覽、經核准後才儲存，並在本機備份，變更需應用程式同步後才生效。多次登入失敗可能導致帳號被鎖定。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Alpha Progression Mcp，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

Alpha Progression MCP

Connect Claude (or any MCP client) to your Alpha Progression gym data: analyse your training and adjust your plan.

  • "Am I doing enough sets per week for each muscle?"
  • "Which lifts have stalled in the last 3 months?"
  • "Add a hamstring exercise to Day 2 and lower bench to 4 × 6."

Unofficial, not affiliated with Alpha Progression. Use it only with your own account.

Setup

Requires uv.

  1. Log in once. Your email and password are not saved, only an access token (~/.config/alpha-progression-mcp/token.json):
    sh
    uvx alpha-progression-mcp login
  2. Add it to Claude Code:
    sh
    claude mcp add alpha-progression -- uvx alpha-progression-mcp
    Other clients:
    json
    {  "mcpServers": {    "alpha-progression": {      "command": "uvx",      "args": ["alpha-progression-mcp"]    }  }}
  3. Restart your client.

Tools

ToolReturns
get_weekly_trainingSets and training days per muscle, per week
get_progressLifts improving or stalled, by muscle group (e1RM)
get_sessions / get_sessionRecent workouts / every set of one workout
get_exercise_historyOne exercise over time
find_exercisesExercises by name or muscle
get_plansYour current plan with set and rep targets
get_measurementsBodyweight and other measurements
get_documentAny single record
set_plan_targets / add_plan_exercise / swap_plan_exercise / remove_plan_exerciseChange one thing in your plan

Plan editing makes one targeted change per call, previews it first and only saves after you approve. Workout history is never touched; a backup of the plan is saved to ~/.config/alpha-progression-mcp/backups/ before each change, and it only changes what the free version of the app can (no RIR targets, deloads or periodisation). Changes appear in the app after it syncs. To turn editing off, set ALPHA_PROGRESSION_READ_ONLY=1.

Names can be partial ("bench press", "day 2"); unclear ones return suggestions.

Metrics: working sets exclude warm-ups (lighter sets before the first heavy set) and stretches. Sets per muscle count 1 for the target muscle and 0.5 for its main secondary muscles (fractional counting, Pelland et al. 2024). e1RM uses Epley, weight × (1 + reps / 30), up to 15 reps.

Troubleshooting

  • "Not logged in" / "login has expired": run the login command again.
  • "Too many login attempts": wait a few minutes; Alpha Progression locks login after wrong passwords.
  • Check the connection: uvx alpha-progression-mcp status
  • Log out: delete ~/.config/alpha-progression-mcp/token.json.

Development

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

The sync protocol is described in docs/api.md. MIT license.

來源：README.md，提交 ef7354f

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包，因此其工具未知。

版本歷史

1
  1. v0.1.1最新Oct 29, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手；SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分