项目简介

'oura-mcp' 是一个基于 Model Context Protocol (MCP) 构建的服务器端实现，用于连接和获取 Oura Ring 的健康数据。它将 Oura API 提供的各种健康指标（如活动、睡眠、心率等）封装成 MCP 工具，使得兼容 MCP 协议的大语言模型 (LLM) 客户端能够标准化地访问这些数据。

主要功能点

Oura 数据集成: 通过 Oura API 获取用户的个人信息、日常活动、心血管年龄、睡眠、SpO2（血氧）、压力、心率等健康数据。
MCP 工具暴露: 将获取 Oura 数据的能力注册为 LLM 可调用的工具，LLM 可以通过这些工具请求特定日期范围或类型的数据。
多传输协议支持: 支持 Stdio (标准输入输出)、SSE (Server-Sent Events) 和 HTTP 等传输方式与 MCP 客户端通信。
能力声明: 向客户端声明其提供的工具能力。

安装步骤

该项目通常通过 'npx' 命令直接运行，无需复杂的安装过程。确保您的系统已安装 Node.js 环境。

服务器配置（适用于 MCP 客户端）

MCP 服务器通常作为 MCP 客户端的子进程启动或由客户端连接。以下是一个典型的 MCP 客户端配置示例（JSON 格式），用于通过 Stdio 方式启动 'oura-mcp' 并与之通信：

{
  "mcpServers": {
    "oura": {
      "command": "npx", // 启动服务器的命令
      "args": ["-y", "oura-mcp"], // 命令参数，-y 自动确认安装依赖
      "env": {
        "OURA_ACCESS_TOKEN": "<YOUR_OURA_API_TOKEN>" // Oura API 访问令牌，需要替换为您的实际令牌
      }
    }
  }
}

'command': 指定用于启动 'oura-mcp' 的可执行命令。
'args': 传递给命令的参数。'-y oura-mcp' 告诉 'npx' 运行 'oura-mcp' 包，并自动确认安装。
'env': 传递给服务器进程的环境变量。'OURA_ACCESS_TOKEN' 是必需的，用于认证 Oura API 请求。

如果使用 SSE 或 HTTP 模式，客户端配置会有所不同，通常使用 'url' 字段指定服务器地址。

基本使用方法

在 Oura Cloud 官网创建一个个人访问令牌。
将上述 JSON 配置中的 '<YOUR_OURA_API_TOKEN>' 替换为您获取的令牌。
将此配置集成到您的 MCP 客户端（具体方法取决于您使用的客户端）。
启动 MCP 客户端。客户端将根据配置自动启动 'oura-mcp' 服务器（例如通过 Stdio），并通过 MCP 协议与之建立连接和进行数据交互。客户端随后便可以通过 MCP 协议调用 'oura-mcp' 暴露的工具来获取您的 Oura 数据。

关键词

信息