Wellness Project

Wellness Project MCP

将互联的健康与健身数据接入 Claude、ChatGPT、Gemini Spark、Gemini CLI、Grok、Mistral 及其他 MCP 客户端。 Wellness Project 是一个托管的模型上下文协议服务。你的设备和日志会同步到同一个账户，受支持的助手可以用通俗语言读取或更新锻炼、营养、睡眠、恢复、身体指标、目标、化验结果、身心健康等数据。

此仓库是托管服务的公开文档和目录，不是可自托管的后端，也不包含私有服务实现。

• 应用：https://wellnessproject.ai
• MCP 端点：https://wellnessproject.ai/api/mcp
• 73 个公开工具，由生产环境工具注册表生成
• 15 个交互式小组件，适用于兼容 MCP Apps UI 的客户端
• 使用动态客户端注册的 OAuth 2.1 身份验证

---

你可以询问什么

连接后，你可以自然地提问，助手会调用相应的 Wellness Project 工具：

• “我这周的训练情况怎么样？”
• “显示我上个月的睡眠情况。”
• “我的卧推进展如何？”
• “记录今天的午餐：鸡肉卷饼碗，大约 700 卡路里。”
• “本季度我的静息心率趋势与 HRV 相比如何？”
• “我的目标完成得怎么样？”
• “记录 16 盎司饮用水。”

读取工具会返回你记录和同步的健康数据。你提出请求时，写入工具会添加、更新或删除记录。小组件工具可以呈现结构化的交互视图，而不是一屏数字。

将 Wellness Project 连接到 MCP 客户端

首先，在 https://wellnessproject.ai 创建账户，并在 Settings → Devices 下连接你需要的健康数据来源。以下所有客户端都使用同一个托管端点：

https://wellnessproject.ai/api/mcp

身份验证通过 OAuth 处理。当前公开连接流程不使用个人 API 密钥。

Claude

1. 在网页上打开 Claude。
2. 前往 Customize → Connectors → Add custom connector。
3. 粘贴 https://wellnessproject.ai/api/mcp。
4. 如果 Claude 显示 Client ID 和 Client Secret 字段，请留空。Claude 可以动态注册自身。
5. 登录 Wellness Project 并授权连接。

Claude Code

Claude Code 通过插件安装 Wellness Project。插件仅包含此服务的配置和一个设置技能。

/plugin marketplace add turnnoblindeye/wellness-project-mcp
/plugin install wellness-project

重启 Claude Code，然后运行 /mcp，选择 wellness-project 并授权。 无需输入客户端 ID、客户端密钥或 API 密钥。如果你希望获得引导式设置，请运行 /wellness-project:setup。

Gemini CLI

Wellness Project 已列入 Gemini CLI 扩展官方目录。从此公开仓库安装扩展：

gemini extensions install https://github.com/turnnoblindeye/wellness-project-mcp

重启 Gemini CLI，然后运行 /mcp list，检查是否有 wellness-project 服务。如果需要身份验证，请运行 /mcp auth wellness-project，并在浏览器中登录 Wellness Project。授权后，向 Gemini 询问有关锻炼、营养、睡眠、恢复或目标的问题，或请求更新日志。

此连接使用托管的 MCP 端点，因此无需本地服务或个人 API 密钥。Gemini CLI 的 OAuth 流程需要浏览器，并且需要访问 localhost 回调。详情请参阅 Gemini CLI 的 MCP 身份验证文档。

Cline

Cline 将 Wellness Project 作为远程 MCP 服务连接。无需克隆、安装或在本地运行。

1. 在 Cline 侧边栏中打开 MCP Servers 图标，然后选择 Remote Servers。
2. 输入服务名称，例如 wellness-project。
3. 将 https://wellnessproject.ai/api/mcp 粘贴为服务 URL，然后添加。
4. Cline 在浏览器中打开页面后，完成 Wellness Project OAuth 流程。

也可以直接编辑 cline_mcp_settings.json：

{
  "mcpServers": {
    "wellness-project": {
      "type": "streamableHttp",
      "url": "https://wellnessproject.ai/api/mcp",
      "disabled": false,
      "autoApprove": []
    }
  }
}

明确设置 "type": "streamableHttp"。如果未指定类型，Cline 会回退到旧版 SSE 传输方式。无需输入客户端 ID、客户端密钥或 API 密钥。llms-install.md 中也为负责设置的 Agent 列出了相同步骤。

ChatGPT

ChatGPT 自定义 MCP 应用需要开发者模式。OpenAI 当前的可用性取决于套餐：Business、Enterprise 和 Edu 套餐的用户可在测试版中使用完整 MCP 支持，包括写入和修改操作；Pro 套餐的用户可在开发者模式中连接具有读取/获取权限的 MCP。

1. 根据你的 ChatGPT 套餐，在账户或工作区中启用开发者模式。
2. 在 ChatGPT 的 Apps 设置中创建自定义 MCP 应用。
3. 将 https://wellnessproject.ai/api/mcp 用作远程 MCP 服务。
4. 完成 Wellness Project OAuth 流程。

OpenAI 当前的设置和套餐详情：https://help.openai.com/en/articles/12584461

Gemini Spark

自定义 MCP 应用需要 Gemini Spark 访问权限，并且需从 Gemini 网页应用中添加。

1. 前往 https://gemini.google.com。
2. 打开 Settings & help → Connected Apps。如有需要，先打开 Personal Intelligence → Connected Apps。
3. 在 Custom apps for Spark 下，选择 Add a custom app。
4. 输入 https://wellnessproject.ai/api/mcp，然后点击 Next。
5. 完成 Wellness Project OAuth 流程。

Google 当前的资格和可用性规则：https://support.google.com/gemini/answer/17209137

Grok

1. 前往 https://grok.com/connectors，选择 New Connector → Custom。
2. 粘贴 https://wellnessproject.ai/api/mcp。
3. 如果出现 Client ID 和 Client Secret 字段，请留空。
4. 完成 Wellness Project OAuth 流程。

Grok 连接器的可用性可能取决于你的 Grok 套餐。

Mistral Le Chat

1. 在 Le Chat 中，打开 Intelligence → Connectors → Add Connector → Custom MCP Connector。
2. 粘贴 https://wellnessproject.ai/api/mcp。
3. 如果出现 Client ID 和 Client Secret 字段，请留空。
4. 完成 Wellness Project OAuth 流程。

工作区权限可能要求由所有者或管理员添加连接器。

演示

一段简短的屏幕录制，展示 Wellness Project 连接器在 ChatGPT 中运行：

观看演示

交互式组件

在兼容的客户端中，15 个活跃工具可通过 MCP Apps UI 扩展呈现交互式视图：

提问	组件工具
“给我看看健康概况”	show_health_overview
“我的 Fit Score 表现如何？”	show_week_fit_score
“显示我的锻炼”	show_week_workouts
“显示那次锻炼”	show_workout
“显示我的宏量营养素”	show_week_macros
“显示我的饮食日记”	show_meal_diary
“我的睡眠趋势如何？”	show_week_sleep
“显示昨晚的睡眠情况”	show_sleep_detail
“本周的步数呢？”	show_week_steps
“我的体重趋势”	show_body_weight
“显示我的身体成分”	show_body_composition
“恢复趋势”	show_recovery
“我的跑步情况如何？”	show_runs
“我的卧推进展如何？”	show_exercise_progression
“显示我的身心健康状况”	show_wellbeing

许多趋势组件支持多个时间范围；详情组件会使用请求中相关的日期或记录。

工具目录

按领域分组的73 个已公布公共工具的完整生产生成列表见 TOOLS.md。机器可读的描述、注释和 JSON Schema 见 catalog/tools.json。

这两个文件均由与 tools/list 相同的生产工具注册表生成。仅供管理员使用的工具，以及虽仍可供旧版缓存客户端调用、但已退役的工具，不会列入此目录。

请勿手动编辑生成的目录。

数据源与集成

Wellness Project 汇集原生移动健康数据存储、直接集成、转接数据源，以及手动或聊天记录的数据。

数据源	当前支持
Apple Health	原生 iOS 健康与健身同步
Google Health Connect	原生 Android 健康与健身同步
Fitbit / Google Health	可用时支持活动、睡眠、心率、锻炼、身体和营养数据
Oura	睡眠、准备度／恢复、心率和活动数据
Withings	身体、睡眠、活动、心率、血压及其他受支持的健康数据
Wyze	受支持的 Wyze 健康数据
Hevy	通过直接集成获取力量训练历史记录
Ultrahuman	戒指数据及受支持的代谢／CGM 数据
Liftosaur	通过直接集成获取力量训练历史记录
Polar	活动、睡眠、恢复、心率和训练数据
WHOOP	正通过可用性限制分阶段推出直接集成
手动记录／聊天记录	锻炼、膳食、饮水、身体指标、化验结果、受伤情况、补充剂、目标、身心健康状况等

Garmin、Samsung Health、Amazfit/Zepp、Coros、Wahoo、Strava、Peloton、智能体重秤及其他兼容的数据源，也可通过 Apple Health 或 Health Connect 接入 Wellness Project，前提是这些服务会将相关数据写入其中。

定价与状态

以下定价反映截至 2026 年 9 月 7 日的当前生产配置。本地应用商店的价格可能有所不同。

方案	价格	状态
Free Basic	$0	记录和编辑仍免费；从 2026 年 10 月 15 日起，Free 每天可提问 3 个分析问题
Founder Pro monthly	$4.99/month	Founder 价格适用至 2026 年 10 月 15 日
Founder Pro annual	$39.99/year	Founder 价格适用至 2026 年 10 月 15 日
Founder Lifetime	$199 one-time	限量 Founder 方案，即将停售
Pro monthly	$9.99/month	标准价格
Pro annual	$99.99/year	标准价格

隐私与身份验证

• 公共 MCP 端点使用 OAuth 2.1；受支持的客户端可动态注册。
• 每个 MCP 请求都限定在经过身份验证的 Wellness Project 账户范围内。
• 数据层通过行级安全保护用户拥有的记录。
• 无需自托管或轮换长期个人 API 密钥，即可撤销连接器访问权限。

Wellness Project 是信息类软件，不是医疗产品。

常见问题解答

我需要自托管任何内容吗？

不需要。https://wellnessproject.ai/api/mcp 是托管的生产服务。此 GitHub 仓库仅发布文档和架构。

不同 AI 助手可以使用同一个端点吗？

可以。Claude、符合条件的 ChatGPT 账户／工作区、Gemini Spark、Gemini CLI、Grok、Mistral 和其他兼容的远程 MCP 客户端都可以使用同一个端点。各产品和套餐的客户端 MCP 可用性和权限有所不同。

Wellness Project 是免费的吗？

提供免费 Basic 套餐。付费的 Founder Pro 和标准 Pro 套餐可提升分析容量并提供其他付费功能；当前价格见上文。

我的健康数据是否私密？

访问 MCP 需要经过身份验证的 OAuth 授权，每个工具都在已登录用户的账户上运行。当您不再希望客户端保持连接时，可以撤销连接器访问权限。

相关内容

• 适用于 Wellness Project：https://wellnessproject.ai/works-with
• 将 Apple Health 连接到 Claude：https://wellnessproject.ai/integrations/apple-health-to-claude
• Fitbit MCP：https://wellnessproject.ai/integrations/fitbit-mcp
• Claude 集成：https://wellnessproject.ai/integrations/claude
• ChatGPT 集成：https://wellnessproject.ai/integrations/chatgpt

许可证

此仓库中的工具目录和架构采用 MIT License 发布，MCP 客户端和目录可自由引用。"Wellness Project" 和应用本身仍归 Wellness Project LLC 所有。授权范围请参阅 NOTICE。