我们的 MCP 服务器

一个用于访问 Oura Ring 数据的 Model Context Protocol (MCP) 服务器。

安装指南

先决条件

• Node.js（v16+）
• Oura 账户

安装步骤

1. 克隆仓库
2. 运行：

npm install
npm run build

配置指南

获取凭证

1. 登录 Oura Cloud Console
2. 获得以下任意一种：
   • 个人访问令牌（用于测试）
   • OAuth2 凭证（用于生产）

环境变量配置

创建一个 .env 文件：

# 选项1：个人访问令牌
OURA_PERSONAL_ACCESS_TOKEN=your_token

# 选项2：OAuth2 凭证
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 的配置文件中添加以下内容（路径：设置 → 开发者 → 编辑配置）：

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

保存后重启 Claude Desktop。更多详情请参考 MCP 文档。

可用资源

• personal_info - 用户资料
• daily_activity - 活动摘要
• daily_readiness - 准备度评分
• daily_sleep - 睡眠摘要
• sleep - 详细睡眠数据
• sleep_time - 睡眠时间安排
• workout - 训练数据
• session - 时段数据
• daily_spo2 - 血氧饱和度测量
• rest_mode_period - 休息时段
• ring_configuration - 戒指配置
• daily_stress - 压力指标
• daily_resilience - 恢复力指标
• daily_cardiovascular_age - 心血管年龄
• vO2_max - 有氧能力数据

可用工具

对于基于日期的资源，可以使用如 get_daily_sleep 这样的工具，并指定 startDate 和 endDate 参数（格式：YYYY-MM-DD）。