非公式ウルトラヒューマンリングMCPサーバー：AIエージェント統合ガイド

概要

Ultrahuman Partner APIをラップする非公式のModel Context Protocol（MCP）サーバーで、AIコーディングエージェントがUltrahuman RingおよびCGMデバイスから直接ヘルスデータをクエリできるようにします。

主な機能と実装

このサーバーはAIエージェント向けに2つの主要ツールを提供します：

日次メトリクス： 指定した日付の完全なデータダンプをJSONまたはマークダウン形式で返します。
ライブ値： 単一のメトリクス（例：回復スコア、睡眠スコア、HRV）を取得して迅速な状態チェックを行います。

利用可能なメトリクスには、睡眠データ、HRV、安静時心拍数、歩数、回復スコア、血糖値測定値、代謝スコア、VO2max推定値が含まれます。

セットアップと要件

このプロジェクトには以下が必要です：

Python 3.10以上
Ultrahuman Partner APIアクセス（アプリの「ヘルプを求める」セクションで取得したトークン）
認証用のアカウントメールアドレス

認証情報は環境変数（ULTRAHUMAN_TOKENおよびULTRAHUMAN_EMAIL）を通じて排他的に管理され、ハードコードされた値はありません。

互換性とユースケース

このMCPサーバーは、Claude Code、Cursor、OpenClawなど、MCPをサポートするAIセットアップで動作します。リポジトリには、モデルがツールをいつ呼び出すべきか、朝のブリーフィング、回復チェック、シンプルな分析（週次ビュー、トレンド）のためにデータをどのように提示するかを理解するのに役立つスキルが含まれています。

週次サマリーのチャート付きPDFレポートを生成するスクリプトも提供されています。