Oura MCP Server

Oura MCP サーバー

Oura API へのアクセスを提供する Model Context Protocol（MCP）サーバーです。LLM が Oura API から睡眠、コンディション、レジリエンスのデータを取得できます。

利用可能なツール

サーバーは以下のツールを公開しています。

日付範囲のクエリ

• 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()：今日のレジリエンスデータを取得します

使い方

このサーバーを使用するには、Oura API トークンが必要です。以下の手順で取得できます。

1. Oura Developer Portal にアクセスします
2. Personal Access Token を作成します

Claude for Desktop

claude_desktop_config.json（macOS では ~/Library/Application\ Support/Claude/claude_desktop_config.json、Windows では %APPDATA%/Claude/claude_desktop_config.json）を更新し、以下を追加します。

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

クエリの例

接続すると、Claude に次のような質問ができます。

• 「今日の睡眠スコアはいくつですか？」
• 「過去 1 週間のコンディションデータを表示してください」
• 「1 月 1 日から 1 月 7 日までの睡眠はどうでしたか？」
• 「今日のレジリエンススコアはいくつですか？」

エラー処理

サーバーは、よくある問題について人が読みやすいエラーメッセージを表示します。

• 無効な日付形式
• API 認証エラー
• ネットワーク接続の問題

ライセンス

このプロジェクトは MIT License のもとでライセンスされています。詳細は LICENSE ファイルをご覧ください。