Ultrahuman Mcp

Ultrahuman MCP Server

Ultrahuman API から健康およびフィットネスの指標を取得するための Model Context Protocol（MCP）サーバーです。TypeScript で構築され、本番環境での使用を想定して設計されています。

🚀 クイックスタート

1. リポジトリをクローンします
2. 依存関係をインストールします：

   bun install
   

3. プロジェクトをビルドします：

   bun run build
   

4. 環境変数を設定します（「設定」セクションを参照）
5. Claude Desktop に追加します（「使用方法」セクションを参照）

🔑 Ultrahuman API の利用開始

この MCP サーバーを使用するには、Ultrahuman の認証情報を取得する必要があります。次の手順に従ってください。

手順 1：Ultrahuman のメールアドレスを確認する

1. デバイスで Ultrahuman アプリを開きます
2. 画面下部の Profile タブに移動します
3. 左上の設定アイコン（歯車アイコン）をタップします
4. 設定画面の上部にメールアドレスが表示されます
5. このメールアドレスをコピーします。設定時に必要になります

手順 2：API キーと Partner ID をリクエストする

次のいずれかの方法で Ultrahuman に連絡し、API キーと Partner ID を取得する必要があります。

• メール：[email protected] にリクエストを送信します
• アプリ内チャット：Ultrahuman アプリ内のカスタマーサービスチャットを使用します

重要：回答を早く受け取れるよう、リクエストには Ultrahuman のメールアドレスを必ず記載してください。

API キーと Partner ID を受け取ったら、安全に保管し、他人に知られないようにしてください。

手順 3：アプリで Partner ID を設定する

1. デバイスで Ultrahuman アプリを開きます
2. 画面下部の Profile タブに移動します
3. 左上の設定アイコン（歯車アイコン）をタップします
4. 下にスクロールして Partner ID フィールドを探します
5. Ultrahuman から受け取った Partner ID コードを入力します

手順 4：MCP サーバーを設定する

これで、認証情報を使ってこの MCP サーバーを設定できます。

1. 環境変数を設定します（下記の「設定」セクションを参照）
2. サーバーをビルドして実行します
3. API 認証情報を使って Claude Desktop に追加します

これで、健康データを取得する準備が整いました！

✨ 主な機能

• Ultrahuman API から包括的な健康指標を取得
• 心拍数、睡眠、歩数、体温、HRV のモニタリング
• 型安全性を考慮して TypeScript で構築
• 高速なテストと開発を実現する Bun
• リンティングとフォーマットに Biome を使用
• クリーンで保守しやすいプロジェクト構成

📂 プロジェクト構成

ultrahuman-mcp/
├── src/
│   ├── tools/          # MCP tools implementation
│   │   └── ultrahumanMetrics/  # Ultrahuman API integration
│   ├── utils/          # Shared utilities
│   ├── main.ts         # Server entry point
│   └── types.ts        # Shared type definitions
├── scripts/            # Build and utility scripts
├── biome.json          # Linting configuration
├── tsconfig.json       # TypeScript configuration
└── package.json        # Project dependencies

⚙️ 設定

このサーバーで Ultrahuman API の認証を行うには、環境変数が必要です。

• ULTRAHUMAN_AUTH_TOKEN：Ultrahuman API の認証トークン
• ULTRAHUMAN_USER_EMAIL：データを取得する Ultrahuman ユーザーのメールアドレス

API のベース URL は https://partner.ultrahuman.com/api/v1 に設定されています。

🔧 利用可能なツール

ultrahuman_metrics

指定した日付の健康およびフィットネスの指標を Ultrahuman API から取得します。ユーザーのメールアドレスは環境変数で設定するため、包括的な健康データを取得するには日付を指定するだけで済みます。

パラメーター：

• date：指標を取得する日付（YYYY-MM-DD 形式。例：'2025-06-19'）

使用例：

{
  "name": "ultrahuman_metrics",
  "arguments": {
    "date": "2025-06-19"
  }
}

📊 取得可能な健康データ

API では、次のような包括的な健康指標を取得できます。

• 心拍数：タイムスタンプ付きの継続的な心拍数モニタリング
• 皮膚温度：1 日を通した体温の変化
• HRV（心拍変動）：心拍変動の測定値
• 歩数：アクティビティ追跡を含む歩数データ
• 睡眠データ：次の項目を含む詳細な睡眠分析：
  • 睡眠ステージ（深い睡眠、浅い睡眠、REM、覚醒）
  • 睡眠効率と品質の指標
  • 睡眠中の心拍数と HRV
  • 睡眠中の体温変化
• 回復指数：全体的な回復スコア
• 運動指数：アクティビティと運動の指標
• VO2 Max：心肺機能のフィットネス指標

💻 Claude Desktop での使用方法

1. プロジェクトをビルドします：

   bun run build
   

2. Claude Desktop の設定（~/Library/Application Support/Claude/claude_desktop_config.json）に追加します：

   {
     "mcpServers": {
       "ultrahuman": {
         "command": "node",
         "args": ["/path/to/your/project/dist/main.js"],
         "env": {
           "ULTRAHUMAN_AUTH_TOKEN": "your_token_here",
           "ULTRAHUMAN_USER_EMAIL": "[email protected]"
         }
       }
     }
   }
   

🧪 テスト

サーバーを直接実行してテストできます。

node dist/main.js

サーバーは stdio で MCP リクエストを待ち受け、API からヘルスデータを取得する ultrahuman_metrics ツールを提供します。

🛠️ 開発

• テストの実行：bun test
• コードのフォーマット：bun run format
• コードの静的解析：bun run lint
• プロジェクトのビルド：bun run build

📜 バージョン管理

このプロジェクトでは、自動バージョン管理に standard-version を使用します。新しいバージョンを作成するには、bun run release を実行します。

コミットメッセージの形式

• feat：新機能（マイナーバージョンが上がります）
• fix：バグ修正（パッチバージョンが上がります）
• BREAKING CHANGE：破壊的変更（メジャーバージョンが上がります）

📦 npm への公開

1. npm にログインしていることを確認します。

   npm login
   

2. プロジェクトをビルドします。

   bun run build
   

3. パッケージを公開します。

   npm publish
   

npm からのインストール（公開後）

Claude Desktop の設定に追加します。

{
  "mcpServers": {
    "ultrahuman": {
      "command": "npx",
      "args": ["-y", "ultrahuman-mcp"],
      "env": {
        "ULTRAHUMAN_AUTH_TOKEN": "your_token_here",
        "ULTRAHUMAN_USER_EMAIL": "[email protected]"
      }
    }
  }
}