Boostcamp MCP服务器
一种用于集成的模型上下文协议（MCP）服务器 Boostcamp 健身平台。此服务器通过Claude Desktop和Claude Code无缝访问您的训练历史、锻炼计划、自定义练习和分析。
与 boostcamp-api Python库 -用于与Boostamp的私有API交互的库。
🚀 快速开始
1.安装
- 克隆此存储库:
git clone https://github.com/Alex-Keyes/boostcamp-mcp.git
cd boostcamp-mcp- 安装依赖项:
使用 uv:
uv sync- 配置Claude桌面:
将此添加到您的Claude Desktop配置文件中：
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json 视窗: %APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"Boostcamp": {
"command": "uv",
"args": [
"run",
"--with",
"mcp[cli]",
"--with-editable",
"/path/to/your/boostcamp-mcp",
"mcp",
"run",
"/path/to/your/boostcamp-mcp/src/boostcamp_mcp/server.py"
]
}
}
}重要：替换 /path/to/your/boostcamp-mcp 与你的实际路径！
- 重新启动克劳德桌面
2.一次性身份验证设置
重要：为了安全起见，通过独立脚本执行身份验证以生成会话。
打开终端并运行：
cd /path/to/your/boostcamp-mcp
uv run login按照提示操作：
- 输入您的Boostcamp电子邮件和密码。
- 该脚本将安全地进行身份验证并在本地保存您的会话。
- 会话令牌存储在
.env归档.boostcamp/目录（git自动忽略）。
3.开始使用
一旦通过身份验证，直接在Claude中使用这些工具：
get_my_profile-查看您的个人资料和一般统计数据。list_enrolled_programs-查看您当前的活动程序。get_training_history-回顾你过去的训练。get_home_summary-获取您的仪表板记录和总计。
✨ 特性
📊 健身分析
- 主页摘要：获得总锻炼量、总移动重量和本周连胜。
- 交易量图表：访问随时间推移的培训量数据。
- 肌肉分布：看看你瞄准了哪些肌肉群。
🏋️ 锻炼管理
- 程序详细信息：获取完整的锻炼计划，包括训练集、重复次数和教练笔记。
- 已注册课程：跟踪你在积极训练计划中的进展。
- 自定义练习：访问您手动创建的练习。
📚 内容与发现
- 程序目录：搜索并列出平台上所有可用的程序。
- 博客访问：阅读Boostcamp博客上的最新文章和培训指南。
🛠️ 可用工具
| 工具 | 说明 | 参数 |
|---|---|---|
get_my_profile | 获取用户配置文件和设置 | 无 |
list_enrolled_programs | 列出您的活动程序 | 无 |
get_training_history | 获取详细的锻炼历史记录 | timezone_offset |
get_payment_history | 查看您的订阅/订单 | 无 |
list_custom_exercises | 列出你的独特练习 | 无 |
list_all_programs | 搜索程序目录 | page, page_size, keyword |
get_program_details | 获取程序ID的完整计划 | program_id |
list_blogs | 列出最近的博客文章 | page, page_size |
get_home_summary | 仪表板统计数据（连胜/总计） | timezone_offset |
get_home_chart | 培训量图表数据 | timezone_offset |
get_home_muscle | 肌群分布 | timezone_offset |
🔧 故障排除
身份验证问题
如果您看到“身份验证错误”或令牌过期消息：
- 运行登录命令：
uv run login - 重新启动MCP客户端（克劳德桌面或克劳德代码）。
会话管理
- 会话存储在
.boostcamp/session.pickle. - 这
BOOSTCAMP_AUTH_TOKEN已保存到您的本地.env. - 安全说明：永远不要承诺你的
.env或.boostcamp/文件夹。它们包含在.gitignore默认情况下。
📄 许可证
MIT许可证