JinDaGe - oura-mcp MCP Details

article

README

🚀 我们的 MCP 服务器

这是一个用于访问 Oura Ring 数据的 Model Context Protocol (MCP) 服务器，借助它可方便地获取 Oura Ring 的相关数据，为用户提供数据支持。

🚀 快速开始

要使用本 MCP 服务器，你需要先完成安装和配置，之后就可以进行测试和集成操作。

📦 安装指南

先决条件

Node.js（v16+）
Oura 账户

安装步骤

克隆仓库
运行以下命令进行依赖安装和构建：

npm install
npm run build

📚 详细文档

配置指南

获取凭证

登录 Oura Cloud Console
获得以下任意一种凭证：
- 个人访问令牌（用于测试）
- 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）。

oura-mcp