用途
Wellness Project MCP 是一个托管的 MCP(Model Context Protocol)服务器,用于把已连接的健康与健身数据带进 Claude、ChatGPT、Gemini Spark、Grok、Mistral 等兼容 MCP 的助手。用户的设备与日志同步到同一个账户后,受支持的助手可以用自然语言读取或更新锻炼、营养、睡眠、恢复、身体指标、目标、化验、健康状态等内容。
该 GitHub 仓库是公开文档和目录,不是自托管后端,也不包含私有服务器实现。
主要能力
- 通过一个托管端点连接多个 AI 助手。
- 自然语言问答,例如:“这周我的训练情况如何?”“显示我最近一个月的睡眠。”“我的卧推进展怎么样?”“记录今天的午餐:鸡肉墨西哥卷饼碗,约 700 卡路里。”“本季度我的静息心率趋势与 HRV 相比如何?”“我的目标完成得怎么样?”“记录 16 盎司水。”
- 读取类工具返回已记录和同步的健康数据;写入类工具在用户要求时新增、更新或删除条目。
- 组件工具可在兼容的 MCP Apps UI 客户端中渲染结构化交互视图,而不是展示大量数字。
- 目录中包含由生产工具注册表生成的 73 个公开工具,以及 15 个活跃的交互式组件。
使用方式
- 先在 https://wellnessproject.ai 创建账户,并在 Settings → Devices 连接需要的健康数据来源。
- 所有客户端共用同一托管端点:https://wellnessproject.ai/api/mcp。认证由 OAuth 处理,当前公开连接流程不使用个人 API 密钥。
Claude(网页版)
- 打开网页版 Claude。
- 进入 Customize → Connectors → Add custom connector。
- 粘贴 https://wellnessproject.ai/api/mcp。
- 如果 Claude 显示 Client ID 和 Client Secret 字段,留空。Claude 可以自行动态注册。
- 登录 Wellness Project 并授权连接。
Claude Code
Claude Code 会把 Wellness Project 作为插件安装,插件只包含该服务器的配置和一组设置技能。
- 重启 Claude Code。
- 运行 /mcp,选择 wellness-project 并授权。无需输入 Client ID、Client Secret 或 API 密钥。
- 如果需要引导,运行 /wellness-project:setup。
Cline
Cline 以远程 MCP 服务器方式连接 Wellness Project,不克隆、不安装、不在本地运行任何内容。
- 打开 Cline 侧边栏中的 MCP Servers 图标,选择 Remote Servers。
- 输入服务器名称,例如 wellness-project。
- 粘贴 https://wellnessproject.ai/api/mcp 作为服务器 URL 并添加。
- 当 Cline 在浏览器中打开时,完成 Wellness Project OAuth 流程。
若要直接编辑 cline_mcp_settings.json:需显式设置 "type": "streamableHttp"。省略 type 时,Cline 会回退到旧版 SSE 传输。无需输入 Client ID、Client Secret 或 API 密钥。llms-install.md 中为执行安装的智能体写了相同步骤。
ChatGPT
ChatGPT 自定义 MCP 应用使用开发者模式。当前 OpenAI 的可用性取决于计划:包含写入/修改操作的完整 MCP 支持以测试版形式面向 Business、Enterprise 和 Edu 提供;Pro 可在开发者模式下连接具有读取/获取权限的 MCP。
- 按 ChatGPT 计划允许的方式为账户或工作区启用开发者模式。
- 从 ChatGPT 的 Apps 设置创建自定义 MCP 应用。
- 使用 https://wellnessproject.ai/api/mcp 作为远程 MCP 服务器。
- 完成 Wellness Project OAuth 流程。
OpenAI 当前设置与计划详情:https://help.openai.com/en/articles/12584461
Gemini Spark
自定义 MCP 应用需要 Gemini Spark 访问权限,并从 Gemini 网页应用添加。
- 打开 https://gemini.google.com。
- 打开 Settings & help → Connected Apps;如需要,先打开 Personal Intelligence → Connected Apps。
- 在 Custom apps for Spark 下选择 Add a custom app。
- 输入 https://wellnessproject.ai/api/mcp 并点击 Next。
Google 当前资格与可用性规则:https://support.google.com/gemini/answer/17209137
Grok
- 打开 https://grok.com/connectors,选择 New Connector → Custom。
- 如果出现 Client ID 和 Client Secret 字段,留空。
- Grok 连接器可用性可能取决于 Grok 计划。
Mistral Le Chat
- 在 Le Chat 中打开 Intelligence → Connectors → Add Connector → Custom MCP Connector。
- 工作区权限可能要求所有者或管理员添加连接器。
交互式组件
十五个活跃工具通过兼容客户端中的 MCP Apps UI 扩展渲染交互视图。许多趋势组件支持多个时间范围;详情组件使用与请求相关的日期或记录。
完整的 73 个公开工具列表(按领域分组)见 TOOLS.md。机器可读的描述、注解和 JSON Schema 见 catalog/tools.json。这两个文件都由 tools/list 使用的同一生产工具注册表生成。仅管理员工具和仅供旧缓存客户端调用的已退役工具不在该目录中展示。请勿手动编辑生成的目录。
数据来源与集成
Wellness Project 结合原生移动健康存储、直接集成、中转来源以及手动/聊天记录。Garmin、Samsung Health、Amazfit/Zepp、Coros、Wahoo、Strava、Peloton、智能秤以及其他兼容来源,在把相关数据写入 Apple Health 或 Health Connect 时,也可通过它们到达 Wellness Project。
价格与状态
资料称价格反映截至 2026 年 9 月 7 日的当前生产配置,本地应用商店价格可能不同。资料提到有 Free Basic 免费版,付费 Founder Pro 和标准 Pro 计划增加分析能力及其他付费功能,并称当前价格已在文中列出,但未提供具体价格金额,暂未提供具体价格。
隐私与认证
- 公开 MCP 端点使用 OAuth 2.1,受支持的客户端可动态注册。
- 每个 MCP 请求都限定在已认证的 Wellness Project 账户范围内。
- 数据层使用行级安全保护用户自有记录。
- 可以撤销连接器访问,无需自托管或轮换长期有效的个人 API 密钥。
- Wellness Project 是信息类软件,不是医疗产品。
适用场景与限制
适用于希望在 AI 助手中以自然语言查询、记录和管理个人健康与健身数据的用户。限制包括:服务为托管式,本仓库不含服务器实现,无法自托管;客户端侧 MCP 可用性和权限因产品与计划而异;ChatGPT 的 MCP 支持取决于计划;Gemini 自定义应用需要 Spark 访问权限;Grok 连接器可用性可能取决于计划;Mistral 工作区权限可能需要管理员。资料未提供具体收费价格、完整工具清单细节或医疗用途声明,相关事实暂未提供。