mi-health-mcp

プロジェクト概要

mi-health-mcp は、小米运动健康 の家族・友人のデータ（睡眠、心拍数、歩数）を MCP プロトコル経由で RikkaHub などの LLM クライアントに公開します。サービスは Cloudflare Workers 上で動作し、自前サーバーは不要で、Cloudflare の無料枠内で利用できます。本プロジェクトは Misty02600/mi-fitness-python のインターフェース解析（リバースエンジニアリング）の成果を基に、Cloudflare Worker + MCP サービスとして書き直したものです。上流プロジェクトに感謝します。

Related MCP server: Health Vault

ワンクリックデプロイ

デプロイ手順では Cloudflare KV のバインディングが必要です。ボタン操作で KV namespace の作または選択を求められた場合は、案内に従って完了し、バインディング名が MI_HEALTH_KV になるようにしてください。

ボタンが機能しない場合の手動デプロイ

Node.js 20 以上と Cloudflare アカウントが必要です。

git clone https://github.com/wusaki0723/mi-health-mcp.git
cd mi-health-mcp
npm install
npx wrangler login
npx wrangler kv namespace create MI_HEALTH_KV

コマンドの出力にある namespace ID を wrangler.toml に記入し、your-kv-namespace-id を置き換えます。続いてアクセストークンを設定してデプロイします：

npx wrangler secret put AUTH_TOKEN
npx wrangler deploy

AUTH_TOKEN には自分で生成した長いランダム文字列を使用してください。ソースコード、wrangler.toml、Git には書き込まないでください。

デプロイ後の設定

1. KV namespace を作成します：

   npx wrangler kv namespace create MI_HEALTH_KV

2. コマンドの出力にある namespace ID を wrangler.toml の [[kv_namespaces]] に記入し、your-kv-namespace-id を置き換えてから再デプロイします。ワンクリックデプロイの場合は、ボタン操作中に案内に従って KV を作成・バインドすることもできます。

3. 対話式で MCP 認証トークンを設定します。トークンには自分で生成した長いランダム文字列を使用してください：

   npx wrangler secret put AUTH_TOKEN

4. 設定に変更がある場合は再デプロイします：

   npx wrangler deploy

KV バインディング名は MI_HEALTH_KV のままにしてください。

クライアント設定

RikkaHub で「設定 > MCP > 新規接続 > Streamable HTTP」を開き、以下を入力します：

• URL：https://<あなたのドメイン>/mcp

• カスタムヘッダー：Authorization: Bearer <あなたのトークン>

この <あなたのトークン> は、デプロイ時に設定した AUTH_TOKEN と完全に一致している必要があります。

利用手順

1. クライアントは最初に health_login_start を呼び出し、loginUrl を取得します。

2. 任意の QRコードツールを使って loginUrl を QRコードとして表示します。

3. 小米运动健康 アプリで QRコードをスキャンし、ログインを確認します。

4. クライアントは success が返るまで health_login_poll をポーリングします。

5. ログイン成功後、health_latest、health_sleep、health_heart、または health_steps を使用してデータを照会します。

Worker は QRコード画像を生成しません。データ照会時には家族・友人のリストを動的に読み取り、最初の項目を使用します。コド内にユーザー ID をハードコドしません。

利用上の注意

ご自身の小米アカウントへのログイン、および承認済みの家族・友人のデータ照会のみに使用してください。他人のプライバシーを侵害する用途や、小米の利用規約に違反する用途には使用しないでください。

ライセンス

本プロジェクトは GNU General Public License v3.0（GPL-3.0）を採用しており、上流の Misty02600/mi-fitness-python のライセンスと一致しています。