alpha-progression-mcp

Alpha Progression MCP

将 Claude（或任何 MCP 客户端）连接到你的 Alpha Progression 健身数据：分析训练情况并调整训练计划。

• “我每周针对每块肌肉做的组数够吗？”
• “过去 3 个月里，哪些动作的表现停滞了？”
• “在第 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	近期训练 / 某次训练的每一组
get_exercise_history	某个动作的长期记录
find_exercises	按名称或肌群查找动作
get_plans	当前训练计划及组数和次数目标
get_measurements	体重和其他测量数据
get_document	任意单条记录
set_plan_targets / add_plan_exercise / swap_plan_exercise / remove_plan_exercise	更改计划中的一项内容

计划编辑每次调用只进行一项有针对性的更改，会先预览，只有在你批准后才会保存。不会更改训练记录；每次更改前都会将训练计划备份到 ~/.config/alpha-progression-mcp/backups/，并且仅能更改应用免费版支持的内容（不包括 RIR 目标、减载或周期化）。同步后，更改会显示在应用中。若要关闭编辑功能，请设置 ALPHA_PROGRESSION_READ_ONLY=1。

名称可以只输入部分内容（例如“卧推”“第 2 天”）；名称不明确时会返回建议。

**指标：**有效组数不包括热身组（第一组大重量训练前的较轻组）和拉伸。每块肌肉的组数中，目标肌肉计为 1 组，主要辅助肌肉计为 0.5 组（分数计数法，Pelland et al. 2024）。e1RM 使用 Epley 公式计算：重量 × (1 + 次数 / 30)，最多计入 15 次。

故障排除

• **“未登录”/“登录已过期”：**重新运行登录命令。
• **“登录尝试次数过多”：**等待几分钟；输错密码后，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 许可证。