🚀 我们的 MCP 服务器
这是一个用于访问 Oura Ring 数据的 Model Context Protocol (MCP) 服务器，借助它可方便地获取 Oura Ring 的相关数据，为用户提供数据支持。
🚀 快速开始
要使用本 MCP 服务器，你需要先完成安装和配置，之后就可以进行测试和集成操作。
📦 安装指南
先决条件
- Node.js（v16+）
- Oura 账户
安装步骤
- 克隆仓库
- 运行以下命令进行依赖安装和构建：
npm install
npm run build
📚 详细文档
配置指南
获取凭证
- 登录 Oura Cloud Console
- 获得以下任意一种凭证：
环境变量配置
创建一个 .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
示例：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）。