Oura MCP

🚀 我們的 MCP 服務器

這是一個用於訪問 Oura Ring 數據的 Model Context Protocol (MCP) 服務器，藉助它可方便地獲取 Oura Ring 的相關數據，為用戶提供數據支持。

🚀 快速開始

要使用本 MCP 服務器，你需要先完成安裝和配置，之後就可以進行測試和集成操作。

📦 安裝指南

先決條件

• Node.js（v16+）
• Oura 賬戶

安裝步驟

1. 克隆倉庫
2. 運行以下命令進行依賴安裝和構建：

npm install
npm run build

📚 詳細文檔

配置指南

獲取憑證

1. 登錄 Oura Cloud Console
2. 獲得以下任意一種憑證：
   • 個人訪問令牌（用於測試）
   • OAuth2 憑證（用於生產）

環境變量配置

創建一個 .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 <tool_name> <date>

示例：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）。