健康数据访问服务

一个通过Oura Ring API访问个人健康数据的MCP服务器,支持睡眠评分、准备度评分和详细睡眠信息等功能。

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

使用说明

Oura MCP 服务器

这是一个我个人的项目,旨在亲手打造一个MCP(Modded Minecraft Pack,模组化我的世界包)服务器,并获得访问权限 到我的Oura数据。

支持的功能

服务器提供了以下可访问Oura Ring API端点的MCP工具:

  • 获取每日睡眠评分 - 与贡献者一起获取每日睡眠评分
  • 获取每日增强标签 - 获取带有标签类型代码的增强标签, 开始日期,以及自定义名称
  • 获取每日准备度分数 - 获取每日准备度评分 贡献者
  • 获取睡眠信息 - 提供详细的睡眠信息,包括 就寝开始/结束时间

所有工具均可接受 start_date 和 end_date ISO日期格式的参数 (YYYY-MM-DD) 并自动处理分页以返回所有可用数据 适用于该系列。

Oura API

MCP服务器使用的是Oura v2 API,该API有速率限制——请勿滥用 带着这个。

要求

  • Node.js 22及以上版本

安装

  1. 安装依赖项
    npm ci
    
  2. 获取个人访问令牌 https://cloud.ouraring.com/personal-access-tokens
  3. 把它放进 .env 目录中的文件
    OURA_ACCESS_TOKEN={Your token}
    
  4. 将MCP服务器与您的Claude连接起来,替换路径引用为 你克隆仓库到的路径。
    {
      "mcpServers": {
        "oura": {
          "command": "node",
          "args": [
            "--env-file",
            ".../oura-mcp/.env",          // Update path here!
            "--experimental-strip-types",
            ".../oura-mcp/src/main.ts"    // Update path here!
          ]
        }
      }
    }
    

访问令牌

Oura已弃用个人访问令牌的使用,未来您将 可能需要获取一个OAuth访问令牌。