Oura MCP Server

🚀 私たちのMCPサーバー

Model Context Protocol (MCP) サーバーで、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 開発者コンソールにアクセスします。
2. 個人用アクセストークンを作成します。

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 ファイルを参照してください。