Oura MCP Server

Oura MCP サーバー

Oura Ring のデータにアクセスするための Model Context Protocol（MCP）サーバーです。

セットアップ

前提条件

• Node.js（v16 以降）
• Oura アカウント

インストール

1. リポジトリをクローンします
2. 次を実行します：

npm install
npm run build

設定

認証情報の取得

1. Oura Cloud Console にログインします
2. 次のいずれかを取得します：
   • Personal Access Token（テスト用）
   • OAuth2 Credentials（本番用）

環境変数

.env ファイルを作成します：

# Option 1: Personal Access Token
OURA_PERSONAL_ACCESS_TOKEN=your_token

# Option 2: OAuth2 credentials
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 - SpO2 測定値
• rest_mode_period - 休息期間
• ring_configuration - リングの設定
• daily_stress - ストレス指標
• daily_resilience - 回復力指標
• daily_cardiovascular_age - 心血管年齢
• vO2_max - VO2 max データ

利用可能なツール

日付に基づくリソースには、startDate と endDate パラメーター（YYYY-MM-DD）を指定して、get_daily_sleep などのツールを使用します。