JustGains | Workouts & Nutrition Tracking

JustGains MCP 服务

官方 JustGains MCP 服务。它可以让 AI Agent 创建并保存训练计划、查看某人的训练历史和进度、搜索 JustGains 训练动作库、规划路线，并在其 JustGains 账户中记录饮食和体重。

有两种运行方式：连接到托管服务（无需安装），或在自己的设备上运行 mcp-server/ 中的 stdio 服务。

连接到托管服务

端点	传输方式	身份验证
https://justgains.com/connect/mcp	Streamable HTTP	OAuth 2.0

将其添加为远程 MCP 服务，然后使用你手机上使用的 JustGains 账户完成浏览器登录。未经身份验证的请求会返回带有 WWW-Authenticate 挑战的 401，因此 MCP 客户端会自行启动登录流程。身份验证使用带 PKCE S256 的授权码流程、动态客户端注册，以及 workouts progress profile 范围。无需 API 密钥，且此代码库不会存储任何凭据。

Claude Code：

claude mcp add --transport http justgains https://justgains.com/connect/mcp

Cursor 和其他读取 mcpServers 文件的客户端：

{
  "mcpServers": {
    "justgains": {
      "url": "https://justgains.com/connect/mcp"
    }
  }
}

Grok Bot 和 Cursor 插件

此代码库也是适用于 Grok Bot 和 Cursor 的 JustGains 插件（.cursor-plugin/plugin.json、mcp.json、.mcp.json），连接到 https://justgains.com/grok/mcp，使用相同的服务和工具。在 Grok Bot 中，打开 Marketplace，在 JustGains 上架后找到它，然后选择 Add，并在浏览器中完成 JustGains 授权。在对话中使用 @ 提及 JustGains 即可使用它。Marketplace 上架需要审核；发布此代码库并不代表上架申请已获批准。在允许自定义 MCP 服务的情况下，添加一个远程 HTTPS 服务，使用任一 URL 即可。团队策略可能会限制自定义服务。

在本地运行（stdio）

mcp-server/ 是一个使用官方 MCP SDK 编写的 TypeScript stdio MCP 服务。它提供实时的 JustGains 工具目录，因此其架构始终与托管服务一致，并以已登录用户的身份通过 JustGains 工具 API 执行每次调用。它需要 Bun。

git clone https://github.com/JustGains/justgains-connector.git
cd justgains-connector/mcp-server
bun install
bun run login   # opens the JustGains sign-in in your browser

login 会运行与托管服务相同的 OAuth 流程，并使用环回重定向；轮换刷新令牌会存储在 ~/.justgains/mcp-credentials.json 中。即使不登录，公共工具（训练动作搜索、训练计划生成和预览）仍可使用。然后将客户端指向该服务：

{
  "mcpServers": {
    "justgains": {
      "command": "bun",
      "args": ["run", "/path/to/justgains-connector/mcp-server/src/index.ts"]
    }
  }
}

变量	用途
JUSTGAINS_ACCESS_TOKEN	使用此访问令牌，而非已存储的登录凭据。
JUSTGAINS_MEASUREMENT_SYSTEM	汇总和卡片使用 imperial 或 metric。未设置时使用 imperial。
JUSTGAINS_CREDENTIALS	login 存储凭据的位置。

Dockerfile 会构建并运行同一个 stdio 服务。

工具

标有“account”的工具需要用户登录。每个工具都会声明其只读、破坏性和开放世界提示。

训练

• generate_workout：根据自然语言请求（“30 分钟哑铃推举训练日”）生成并保存训练计划。无需账户。
• show_workout：按 ID 显示训练计划中的动作、组数和休息时间。
• create_workout、update_workout（account）：使用精确的动作、组数、次数、负重和组类型保存或编辑训练计划。
• search_exercises：按名称、肌群或器械搜索动作库，返回写入工具所需的准确动作代码。
• get_exercise_details（account）：获取单个动作的说明、涉及肌群和所需器械。

训练记录与进度（account）

• get_my_workout_logs、get_workout_history：查看已完成训练的日期、动作和顶组。
• get_my_exercise_history：查看某个训练动作记录的每一组，以及个人最佳成绩。
• get_my_top_exercises、get_progress、summarize_my_week、analyze_my_consistency：查看排名、训练量、每周回顾、连续训练记录和训练频率。

训练计划与路线（account）

• search_workout_programs、get_workout_program：浏览多周训练计划。
• create_workout_program、set_my_program_engagement：创建训练计划，或开始、退出计划。
• create_route：规划一条沿道路和步道路线的跑步、骑行、步行或徒步路线。

饮食与体重（account）

• log_my_food：一次记录一整餐；如果未提供份量，会注明估算值；也可更正之前的记录。
• get_my_food_diary、search_foods、remove_my_food：查看饮食日记和每日宏量营养素、搜索食物目录、删除条目。
• log_my_weight、get_my_weight_history：记录体重并查看趋势。
• get_my_profile：查看用户资料、单位和偏好设置。

在 justgains.com/mcp/tools 查看包含完整输入架构的实时目录，或查看 OpenAPI 契约。

试着这样提问

• “使用 JustGains 制定一份 30 分钟的哑铃训练计划，并保存到我的账户。”
• “显示我过去七天内完成的 JustGains 训练。”
• “查看我这个月卧推成绩的变化。”
• “在 JustGains 中记录我早餐吃的两个鸡蛋、两片吐司和一杯加奶咖啡。”

生成的训练计划会保存为计划。打开返回的 JustGains 链接，即可查看动作、开始训练并记录完成的组数。创建计划不会记录已完成的训练。饮食记录会写入已连接用户的饮食日记；如果缺少份量详情或营养估算值，系统会予以注明。移动应用会通过常规同步接收这些更改。

工具响应包含文本和链接，因此该服务也适用于不支持 MCP Apps 卡片的宿主。支持 MCP Apps 的宿主还会显示交互式训练和饮食卡片。写入操作超时后，请先检查结果再重试。重试饮食记录时必须保留原始 requestId，以免产生重复条目。

验证

在代码仓库根目录运行 bun run verify，以验证插件清单和打包路径；对生产环境执行 MCP 初始化和工具发现；搜索公开动作库；检查 OAuth 元数据和注册情况；并验证未经身份验证的请求无法读取私有资料。此命令不会创建训练或饮食记录。

链接

• JustGains
• 在 Claude、ChatGPT 和 Grok Bot 中使用 JustGains
• 隐私政策和条款
• 支持：[email protected]

本代码仓库中的 MIT 许可证适用于此连接器包和 stdio 服务，不适用于托管的 JustGains 服务。