AI导哈

健康数据访问服务器

Oura Ring MCP服务器是一个用于访问Oura Ring健康数据的服务，包括睡眠、活动、准备度、心率和锻炼信息。

  • by SauravPahadia
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 SauravPahadia/oura-mcp

使用说明

Oura环MCP服务器

模型上下文协议（MCP）服务器，用于访问您的Oura Ring健康数据，包括睡眠、活动、准备状态、心率和锻炼信息。

内置 Smithery软件开发工具包

特性

🔧 工具

  • 获取个人信息：检索您的个人信息（年龄、体重、身高、生物性别）
  • 每天睡觉：获取每日睡眠数据，包括总睡眠时间、睡眠阶段和效率
  • 进行日常活动：访问日常活动指标，包括步数、卡路里和距离
  • 做好日常准备：检查准备状态评分、温度偏差和恢复指标
  • 获取心率：查看心率测量值和HRV数据
  • 进行锻炼：检索具有持续时间、强度和卡路里的锻炼会话
  • 睡眠时间：获取包含阶段和指标的详细睡眠会话数据
  • 每天都有压力：访问每日压力测量和恢复指标

📚 资源

  • Oura API文档：Oura API V2快速参考指南

💬 提示词

  • 分析睡眠：对你最近的睡眠质量和模式进行人工智能分析
  • 活动总结：接收您最近活动的综合摘要
  • 准备就绪检查：检查您当前的准备状态和恢复状态，并提出建议

先决条件

  1. Oura Ring帐户：使用创建帐户 Oura iOS 或 安卓 应用
  2. 个人访问令牌：生成一个 https://cloud.ouraring.com/personal-access-tokens

入门指南

  1. 安装依赖项：

    npm install

  2. 启动开发服务器：

    npm run dev

  3. 当Smithery游乐场出现提示时，输入您的Oura个人访问令牌

用法示例

获取睡眠数据

使用 get-daily-sleep 获取睡眠数据的工具：

Start date: 2024-01-01
End date: 2024-01-07

分析睡眠质量

使用 analyze-sleep 提示：

Days: 7

这将获取您最后7天的睡眠数据，并提供人工智能驱动的见解。

检查活动

使用 get-daily-activity 查看您的每日步数、卡路里和活动评分的工具。

检查准备情况

使用 readiness-check 提示根据您的恢复状态获得个性化建议。

配置

服务器需要一个配置参数：

  • 访问令牌 （必填）：您的Oura个人访问令牌

在本地运行时，将令牌作为URL参数传递：

http://127.0.0.1:8081/mcp?accessToken=YOUR_TOKEN_HERE

使用的API端点

此MCP服务器使用Oura API V2端点：

  • /v2/usercollection/personal_info -个人信息
  • /v2/usercollection/daily_sleep -每日睡眠总结
  • /v2/usercollection/daily_activity -日常活动总结
  • /v2/usercollection/daily_readiness -每日准备得分
  • /v2/usercollection/heartrate -心率测量
  • /v2/usercollection/workout -锻炼课程
  • /v2/usercollection/sleep -详细的睡眠课程
  • /v2/usercollection/daily_stress -每日压力数据

日期格式

  • 日期：使用 YYYY-MM-DD 格式（例如。， 2024-01-15)
  • 日期时间：使用ISO 8601格式（例如。， 2024-01-15T10:30:00Z)

发展

编辑 src/index.ts 添加新的工具、资源或提示。服务器将在开发模式下自动重新加载。

项目结构

oura-ring-mcp-server/
├── src/
│   └── index.ts          # MCP server implementation
├── package.json          # Project dependencies
├── smithery.yaml         # Runtime configuration
└── README.md             # This file

构建

为生产而构建：

npm run build

这将在中创建一个捆绑服务器 .smithery/ 目录。

部署

准备好部署了吗？将代码推送到GitHub并部署到Smithery：

  1. 在以下位置创建新存储库 github/新

  2. 初始化git并推送到GitHub：

    git init
git add .
git commit -m "Initial commit: Oura Ring MCP Server"
git branch -M main
git remote add origin https://github.com/YOUR_USERNAME/YOUR_REPO.git
git push -u origin main

  3. 在以下位置部署服务器 史密斯·艾/新

故障排除

身份验证错误

  • 验证您的个人访问令牌是否正确
  • 检查您是否没有在cloud.oraring.com上撤销令牌
  • 确保令牌在配置中正确传递

未返回数据

  • 确保你经常佩戴Oura戒指
  • 打开Oura移动应用程序时数据同步
  • 根据您的戒指型号，某些数据类型可能不可用

速率限制

Oura API有费率限制。如果遇到速率限制错误，请等待几分钟再发出更多请求。

了解更多

许可证

国际学生委员会

相关 MCP