Oura Ring MCP

🚀 Oura MCP 服務器

這是一個 MCP 服務器，可將你的 Oura 智能戒指與 Claude 及其他 AI 助手相連接。它能為你提供關於睡眠、身體狀態及活動的易讀見解，而非僅僅是原始的 JSON 數據。

🚀 快速開始

1. 安裝

npm install -g oura-ring-mcp

或者直接使用 npx（無需安裝）：

npx oura-ring-mcp

2. 使用 Oura 進行身份驗證

選項 A：個人訪問令牌（更簡單）

1. 訪問 cloud.ouraring.com/personal-access-tokens。
2. 創建一個新令牌。
3. 在你的 Claude 桌面版配置中設置 OURA_ACCESS_TOKEN（見下文）。

選項 B：OAuth CLI 流程

1. 在 developer.ouraring.com 創建一個 OAuth 應用。
   • 將重定向 URI 設置為 http://localhost:3000/callback。
2. 運行認證流程：

   export OURA_CLIENT_ID=your_client_id
   export OURA_CLIENT_SECRET=your_client_secret
   npx oura-ring-mcp auth
   

3. 憑證將保存到 ~/.oura-mcp/credentials.json。

3. 配置 Claude 桌面版

添加到 claude_desktop_config.json： 使用個人訪問令牌：

{
  "mcpServers": {
    "oura": {
      "command": "npx",
      "args": ["oura-ring-mcp"],
      "env": {
        "OURA_ACCESS_TOKEN": "your_token_here"
      }
    }
  }
}

使用 OAuth（運行 npx oura-ring-mcp auth 後）：

{
  "mcpServers": {
    "oura": {
      "command": "npx",
      "args": ["oura-ring-mcp"]
    }
  }
}

服務器會從 ~/.oura-mcp/credentials.json 讀取憑證。若要啟用自動令牌刷新，請添加你的 OAuth 憑證：

{
  "mcpServers": {
    "oura": {
      "command": "npx",
      "args": ["oura-ring-mcp"],
      "env": {
        "OURA_CLIENT_ID": "your_client_id",
        "OURA_CLIENT_SECRET": "your_client_secret"
      }
    }
  }
}

重啟 Claude 桌面版。需要 Node >=18。

✨ 主要特性

• 智能格式化 - 以小時/分鐘顯示時長，分數附帶上下文說明（如“85 - 最佳”）。
• 睡眠分析 - 睡眠階段、效率、心率變異性（HRV）及生物特徵數據。
• 身體狀態跟蹤 - 恢復分數及各項因素的詳細分析。
• 活動數據 - 步數、卡路里消耗及運動強度分析。
• 健康指標 - 心率、血氧飽和度（SpO2）、壓力水平、心血管年齡。
• 智能分析 - 異常檢測、相關性分析、趨勢分析。
• 標籤支持 - 對比有/無特定條件下的各項指標。

查看示例輸出 — 瞭解 Claude 針對睡眠、身體狀態、每週總結及智能分析所返回的內容。

💻 使用示例

基礎用法

# 安裝
npm install -g oura-ring-mcp

# 直接使用 npx
npx oura-ring-mcp

高級用法

# 使用 OAuth CLI 流程進行身份驗證
export OURA_CLIENT_ID=your_client_id
export OURA_CLIENT_SECRET=your_client_secret
npx oura-ring-mcp auth

📚 詳細文檔

可以提出哪些問題？

日常檢查：

• “我昨晚睡得怎麼樣？”
• “我今天恢復得足夠進行鍛鍊嗎？”
• “我的身體現在有什麼信號？”

模式與趨勢：

• “我在週末睡得更好嗎？”
• “我應該幾點睡覺才能獲得最佳睡眠？”
• “我的心率變異性是在改善還是下降？”

相關性與見解：

• “酒精會影響我的睡眠質量嗎？”
• “哪些因素能預測我睡眠最佳的夜晚？”
• “運動時間如何影響我的恢復情況？”

對比：

• “比較我本週和上週的睡眠情況”
• “冥想後和不冥想時我的睡眠情況如何？”
• “我開始服用鎂之後有什麼變化？”

異常情況：

• “我的數據中是否有異常讀數？”
• “我昨天的身體狀態為什麼這麼差？”
• “找出我的指標異常的日子”

可用工具

數據檢索

智能分析

資源

提示

遠程部署（Railway）

部署 MCP 服務器以實現遠程訪問。該服務器通過 Oura 代理 OAuth，因此用戶可直接使用其 Oura 賬戶進行身份驗證，無需個人訪問令牌。

1. 創建 Oura OAuth 應用

1. 訪問 Oura OAuth 應用。
2. 創建一個新應用。
3. 將 重定向 URI 設置為：https://your-app.railway.app/oauth/callback。
4. 記錄 客戶端 ID 和 客戶端密鑰。

2. 部署

# 安裝 Railway CLI
npm install -g @railway/cli

# 登錄、初始化並部署
railway login
railway init
railway up

3. 設置環境變量

在 Railway 控制檯中添加：

Railway 會自動設置 PORT 和 RAILWAY_PUBLIC_DOMAIN。

4. 從 Claude.ai 連接

在 Claude.ai 中使用 連接器：

1. 前往設置 > MCP 連接器 > 添加。
2. 輸入你的服務器 URL：https://your-app.railway.app（無需 /mcp）。
3. 留空 OAuth 客戶端 ID 和密鑰（動態註冊會處理）。
4. 你將被重定向到 Oura 以授權訪問你的數據。

5. 從 Claude 桌面版連接

對於 Claude 桌面版，使用 MCP_SECRET + OURA_ACCESS_TOKEN：

{
  "mcpServers": {
    "oura-remote": {
      "url": "https://your-app.railway.app/mcp",
      "headers": {
        "Authorization": "Bearer your_mcp_secret_here"
      }
    }
  }
}

本地測試

# 使用 Oura OAuth（完整流程）
OURA_CLIENT_ID=your_id OURA_CLIENT_SECRET=your_secret pnpm start:http

# 僅使用靜態密鑰（需要 OURA_ACCESS_TOKEN）
OURA_ACCESS_TOKEN=your_pat MCP_SECRET=test-secret pnpm start:http

# 驗證健康端點
curl http://localhost:3000/health

# 檢查 OAuth 元數據（僅在設置了 OURA_CLIENT_ID 時可用）
curl http://localhost:3000/.well-known/oauth-authorization-server

# 測試認證請求（使用靜態密鑰）
curl -X POST http://localhost:3000/mcp \
  -H "Authorization: Bearer test-secret" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"initialize","params":{"capabilities":{}},"id":1}'

📄 許可證

本項目採用 MIT 許可證。

貢獻

有關架構細節和開發指南，請參閱 CLAUDE.md。