关于 Oura MCP Server
Oura MCP Server 是一个用于访问 Oura Ring 数据的 MCP 服务。它面向需要在 AI 客户端中查询睡眠、活动和恢复等健康数据的用户。
主要功能
- 01提供睡眠、活动、准备度等每日数据资源
- 02支持个人访问令牌和 OAuth2 两种认证方式
- 03可按起止日期查询数据
- 04提供 Claude Desktop 配置示例
适用场景
- 01在 Claude Desktop 中查询某段时间的睡眠摘要
- 02分析运动记录与恢复评分之间的关系
- 03查看压力、SpO2 或心血管年龄等指标
MCP 相关
该项目是一个 MCP 服务,将 Oura 数据以资源和工具的形式提供给 MCP 客户端调用。
配置
本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。
暂未收录安装方式
我们还没有获取到这个服务的安装包或远程地址,请按项目 README 中的说明安装。
工具
还没有获取到工具列表
本地服务需要在你的电脑上运行后才能读取工具,维护者暂未提供工具列表。
详细介绍
Oura MCP 服务
用于访问 Oura Ring 数据的模型上下文协议(MCP)服务。
设置
前置要求
- Node.js(v16+)
- Oura 账号
安装
- 克隆仓库
- 运行:
npm install
npm run build
配置
获取凭据
- 登录 Oura Cloud Console
- 获取以下任一凭据:
- Personal Access Token(用于测试)
- OAuth2 Credentials(用于生产环境)
环境变量
创建一个 .env 文件:
# Option 1: Personal Access Token
OURA_PERSONAL_ACCESS_TOKEN=your_token
# Option 2: OAuth2 credentials
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 docs。
可用资源
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)。
评论
支持 Markdown
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。