Oura MCP 服务器

用于访问 Oura 戒指数据的模型上下文协议 (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 的配置 (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 文档。

可用资源

• 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)。