English Français العربية

io.github.dorian-K/alpha-progression-mcp

السجل الرسمي أخرى

Analyse your Alpha Progression gym training and adjust your plan.

الشيفرة المصدرية التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

PYPI package alpha-progression-mcp
Claude Code 
claude mcp add alpha-progression-mcp -- uvx alpha-progression-mcp==0.1.1
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "alpha-progression-mcp": {
            "command": "uvx",
            "args": [
                "alpha-progression-mcp==0.1.1"
            ]
        }
    }
}

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. Alpha Progression MCP
  2. Setup
  3. Tools
  4. Troubleshooting
  5. Development

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):
     uvx alpha-progression-mcp login

  2. Add it to Claude Code:

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

    Other clients:

     {
   "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

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

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

الأسئلة الشائعة

ما هو io.github.dorian-K/alpha-progression-mcp؟

Analyse your Alpha Progression gym training and adjust your plan.

كيف أثبّت io.github.dorian-K/alpha-progression-mcp؟

يعمل على جهازك. في Claude Code: claude mcp add alpha-progression-mcp -- uvx alpha-progression-mcp==0.1.1. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.dorian-K/alpha-progression-mcp إلى مفتاح API؟

لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.

هل io.github.dorian-K/alpha-progression-mcp مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون io.github.dorian-K/alpha-progression-mcp؟

ينشره dorian-k. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.