Oura MCP Server

🚀 我們的 MCP 服務器

這是一個基於 Model Context Protocol (MCP) 的服務器，它提供了對 Oura API 的訪問能力，能夠讓語言模型輕鬆查詢睡眠、準備度和恢復力數據。

✨ 主要特性

• 提供多種數據查詢工具，支持按日期範圍和今日數據進行查詢。
• 為常見問題提供易於理解的錯誤信息，方便調試和使用。

🚀 快速開始

您需要一個 Oura API 令牌才能使用此服務器。可以通過以下步驟獲取：

1. 前往 Oura 開發者控制檯
2. 創建一個個人訪問令牌

💻 使用示例

基礎用法

更新您的 claude_desktop_config.json（位於 ~/Library/Application\ Support/Claude/claude_desktop_config.json macOS 上和 %APPDATA%/Claude/claude_desktop_config.json Windows 上）以包含以下內容：

{
    "mcpServers": {
        "oura": {
            "command": "uvx",
            "args": [
                "oura-mcp-server"
            ],
            "env": {
                "OURA_API_TOKEN": "YOUR_OURA_API_TOKEN"
            }
        }
    }
}

高級用法

一旦連接，您可以詢問 Claude 如下問題：

• “今天我的睡眠分數是多少？”
• “顯示我過去一週的準備度數據”
• “1月1日至1月7日我的睡眠情況如何？”
• “今天的恢復力評分是多少？”

🔧 技術細節

可用工具

該服務器公開了以下工具：

日期範圍查詢

• get_sleep_data(start_date: str, end_date: str)：獲取指定日期範圍內的睡眠數據
• get_readiness_data(start_date: str, end_date: str)：獲取指定日期範圍內的準備度數據
• get_resilience_data(start_date: str, end_date: str)：獲取指定日期範圍內的恢復力數據

日期應以 ISO 格式（YYYY-MM-DD）提供。

今日數據查詢

• get_today_sleep_data()：獲取今天的睡眠數據
• get_today_readiness_data()：獲取今天的準備度數據
• get_today_resilience_data()：獲取今天的恢復力數據

錯誤處理

該服務器為常見問題提供易於理解的錯誤信息：

• 無效日期格式
• API 認證錯誤
• 網絡連接問題

📄 許可證

該項目在 MIT 許可證下發布，詳細信息請參閱 LICENSE 文件。