mcpField
O
Oura MCP Server

Oura MCP Server

本地服务
github.com/elizabethtrykin健康医疗5184 周前更新

关于 Oura MCP Server

Oura MCP Server 是一个用于访问 Oura Ring 数据的 MCP 服务。它面向需要在 AI 客户端中查询睡眠、活动和恢复等健康数据的用户。

主要功能

  1. 01提供睡眠、活动、准备度等每日数据资源
  2. 02支持个人访问令牌和 OAuth2 两种认证方式
  3. 03可按起止日期查询数据
  4. 04提供 Claude Desktop 配置示例

适用场景

  1. 01在 Claude Desktop 中查询某段时间的睡眠摘要
  2. 02分析运动记录与恢复评分之间的关系
  3. 03查看压力、SpO2 或心血管年龄等指标

MCP 相关

该项目是一个 MCP 服务,将 Oura 数据以资源和工具的形式提供给 MCP 客户端调用。

配置

本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。

暂未收录安装方式

我们还没有获取到这个服务的安装包或远程地址,请按项目 README 中的说明安装。

代码仓库

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具,维护者暂未提供工具列表。

详细介绍

Oura MCP 服务

用于访问 Oura Ring 数据的模型上下文协议(MCP)服务。

设置

前置要求
  • Node.js(v16+)
  • Oura 账号
安装
  1. 克隆仓库
  2. 运行:
npm install
npm run build

配置

获取凭据
  1. 登录 Oura Cloud Console
  2. 获取以下任一凭据:
环境变量

创建一个 .env 文件:

# Option 1: Personal Access Token
OURA_PERSONAL_ACCESS_TOKEN=your_token

# Option 2: OAuth2 credentials
OURA_CLIENT_ID=your_client_id
OURA_CLIENT_SECRET=your_client_secret
OURA_REDIRECT_URI=http://localhost:3000/callback

使用方法

测试
node test.js <tool_name> <date>

示例:node test.js get_daily_sleep 2023-05-01

Claude Desktop 集成

将以下内容添加到 Claude Desktop 的配置中(Settings → Developer → Edit Config):

{
    "mcpServers": {
        "oura": {
            "command": "node",
            "args": ["/absolute/path/to/oura-mcp/build/index.js"],
            "env": {"OURA_PERSONAL_ACCESS_TOKEN": "your_token"}
        }
    }
}

保存后重启 Claude Desktop。详情请参阅 MCP docs。

可用资源

  • personal_info - 用户资料
  • daily_activity - 活动摘要
  • daily_readiness - 准备度评分
  • daily_sleep - 睡眠摘要
  • sleep - 详细睡眠数据
  • sleep_time - 睡眠时间
  • workout - 锻炼数据
  • session - 训练数据
  • daily_spo2 - SpO2 测量数据
  • rest_mode_period - 休息时段
  • ring_configuration - 戒指配置
  • daily_stress - 压力指标
  • daily_resilience - 韧性指标
  • daily_cardiovascular_age - 心血管年龄
  • vO2_max - VO2 max 数据

可用工具

对于基于日期的资源,可使用 get_daily_sleep 等工具,并传入 startDate 和 endDate 参数(YYYY-MM-DD)。

评论

支持 Markdown

第一次接触 MCP?

从协议是什么,到在客户端里装上第一个服务,这几条回答覆盖了大多数入门问题。

一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。