strength-training-mcp 0.1.0

MCP server for evidence-based strength training

Strength Training MCP Server

A stateless MCP server exposing 8 tools for evidence-based strength training. Encodes classical powerlifting programs (5/3/1, Texas Method, Madcow, GZCLP, nSuns CAP3, Coan-Philippi, Smolov Jr), the Banister fitness-fatigue model, RPE-based autoregulation, and an adjustment policy engine.

No user data is stored on the server. All state lives in the calling agent. The server is a pure function: same inputs → same outputs.

Installation

# Install uv (one-time)
curl -LsSf https://astral.sh/uv/install.sh | sh

# Install deps + create venv
uv sync --all-extras

Running

# HTTP server
uv run python -m strength_training_mcp.server

# stdio server (Claude Desktop / Claude Code)
uv run strength-training-mcp

HTTP server starts on http://0.0.0.0:8080

• MCP JSON-RPC endpoint at POST /mcp
• Health check at GET /health

Deployment

See modelscope-deploy.md for deploying to ModelScope Inference.

Quick deploy via uvx (ModelScope 自定义MCP → uvx):

# After publishing to PyPI (or use git+https://...)
uvx --from strength-training-mcp strength-training-mcp

To publish a release:

git tag v0.1.0
git push origin v0.1.0

The .github/workflows/publish.yml action will publish to PyPI automatically (once trusted publishing is configured on PyPI).

A Docker image is also supported as a fallback — see deploy.sh.

Agent Integration

See docs/agent-integration/ for setup guides:

• Claude Desktop
• Aura
• Cursor
• Custom Agent (Python SDK)

Tools

Tool	Purpose
list_training_templates	Browse the built-in program library
get_template_plan	Get a specific week's prescribed sessions
lookup_exercise_form	Get form cues + alternatives for an exercise
explain_principle	Explain a training science principle with citation
calculate_fatigue_score	Compute Banister CTL/ATL/TSB from training history
suggest_session_modification	Get adjustment recommendations based on fatigue + actual
apply_plan_adjustment	Apply aggregate adjustments to a week (deload, etc.)
recommend_session_for_today	Compose today's session with rationale

See docs/api.md for full tool reference.

Development

uv sync --all-extras
uv run pytest tests/unit        # unit tests
uv run pytest tests/integration # E2E tests
uv run pytest --cov=src/strength_training_mcp

Knowledge Sources

All templates and principles cite their original public sources. See docs/rts-principles.md for citations.

License

MIT (subject to ModelScope deployment terms).