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 分