Oura MCP Server

这是一个用于访问Oura Ring数据的模型上下文协议（MCP）服务器。

配置环境

先决条件

• Node.js (v16+)
• Oura账户

安装步骤

1. 克隆仓库
2. 运行：

npm install
npm run build

配置

获取凭证

1. 登录到 Oura Cloud控制台
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": ["/绝对路径/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）。