力量训练助手
MCP 服务配置
复制以下 JSON 到 OPClaw 或其他 MCP 客户端的配置文件中即可使用
{
"mcpServers": {
"strength-training": {
"args": [
"strength-training-mcp"
],
"command": "uvx"
}
}
}
Streamable HTTP 传输配置
{
"mcpServers": {
"strength-training": {
"type": "http",
"url": "http://139.155.143.138/mcp"
}
}
}
服务介绍
力量训练 MCP 服务器
一个无状态的MCP服务器,提供了8种基于证据的力量训练工具。编码了经典的力量举计划(5/3/1、Texas Method、Madcow、GZCLP、nSuns CAP3、Coan-Philippi、Smolov Jr),Banister体能-疲劳模型,基于RPE的自调节,以及调整策略引擎。
服务器不存储任何用户数据。 所有状态都存在于调用代理中。服务器是一个纯函数:相同的输入 → 相同的输出。
安装
# Install uv (one-time)
curl -LsSf https://astral.sh/uv/install.sh | sh
# Install deps + create venv
uv sync --all-extras
运行
# HTTP server
uv run python -m strength_training_mcp.server
# stdio server (Claude Desktop / Claude Code)
uv run strength-training-mcp
HTTP 服务器在 http://0.0.0.0:8080 启动
- MCP JSON-RPC 端点位于
POST /mcp - 健康检查位于
GET /health
部署
- ModelScope: 请参阅 modelscope-deploy.md —— 通过
uvx部署。 - 您自己的云服务器/VPS: 请参阅 docs/selfhost.md 获取 systemd + Caddy 设置指南。
在任何机器上快速启动:
# HTTP server (for self-host / remote clients)
uvx --from strength-training-mcp strength-training-mcp-http --port 8080
# stdio server (for Claude Desktop / Claude Code local)
uvx --from strength-training-mcp strength-training-mcp
代理集成
请参阅 docs/agent-integration/ 中的设置指南:
工具
| 工具 | 用途 |
|---|---|
list_training_templates |
浏览内置程序库 |
get_template_plan |
获取特定周的预定训练课程 |
lookup_exercise_form |
获取某个练习的动作提示和替代方案 |
explain_principle |
解释带有引用的训练科学原理 |
calculate_fatigue_score |
根据训练历史计算Banister CTL/ATL/TSB |
suggest_session_modification |
根据疲劳度和实际表现提供建议修改 |
apply_plan_adjustment |
对一周进行总体调整(如减载等) |
recommend_session_for_today |
提供今天训练课程的建议及其理由 |
完整工具参考请见 docs/api.md。
开发
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
知识来源
所有模板和原则均引用其原始公开来源。请参阅 docs/rts-principles.md 查看引用。
许可证
MIT(受ModelScope部署条款约束)。