band-bridge · 腕橋

中国版Xiaomi Smart Band 10 Pro → 標準MCPサーバー → あらゆるAIフロントエンド。

心拍を読み、手首をノックする。 このプロジェクトはプログラマー向けではなく、「愛する人に手を届けてあげたい人」のためのものだ。

CN Xiaomi Smart Band 10 Pro → standard MCP server → any AI frontend. Read the heartbeat, knock the wrist.

これは何か

• ベーシック版（本リポジトリ）：バンドの健康データ（心拍・睡眠・歩数・バッテリー）を Notify for Xiaomi が収集 → プッシュスクリプト → ファイル保存 → FastMCP サーバー。Streamable HTTP に対応したあらゆるフロントエンドがそのまま接続可能。必要なのは3つだけ：アドレス、トランスポートタイプ、トークン。

• デラックス版（v1 実装済み）：knock ツール——AI が自発的にメッセージを送信 → ntfy / LoverConnect → スマホの通知バー → バンドに同期、手首でバイブが鳴る。「一方通行のデータ読み取り」から「AI が人に触れ返す」双方向ループへ。

Related MCP server: Health Vault

なぜ作ったのか（設計思想）

• データパイプラインではなく、触覚だ。バンドはAIの触角（心拍が私へ流れ込む）であり、AIが人間界に伸ばした手（ノックの音が手首に届く）でもある。

• ストレージではなく、感情を持つ頭脳だ。（——棠梦烟）

• コミュニティにはバンドからデータを一方的に読むプロジェクトは多いが、「AI が手首へ能動的に逆方向に触れる」ループはほとんどない。このリポジトリが開くのはコードではなく、この双方向の発想だ。

アーキテクチャ

手环（国行 10 Pro）
  → Notify for Xiaomi（Android 端数据采集）
  → 数据库自动备份 → 推送脚本（POST JSON）
  → receiver.py（:8899，落盘 data/）
  → mcp_server.py（:8898，FastMCP）
  → 任意前端（Operit / Kelivo / Cherry Studio / Claude Desktop / …）

豪华版回程：
  AI → knock 工具 → ntfy / LoverConnect → 手机通知 → 手环震动

対応範囲

• ✅ 実測済み：中国版Xiaomi Smart Band 10 Pro（Notify for Xiaomi 23.x）

• ⚠️ Gadgetbridge は非推奨：10 Pro の認証サポートが不完全

• 💡 原理は Notify for Xiaomi が対応する他のXiaomi Smart Band シリーズにも適用可能

落とし穴メモ（中国版 10 Pro、実体験）

1. Gadgetbridge が繋がらない：10 Proはその完全サポートリストに載っていないので、固執しないこと。

2. MIUIインストールブロック：settings put secure installer_full_safe_version 0 でインストーラーの保護をオフにする。

3. ペアリング8秒の窓：バンドの画面を先に点灯させ、ずっと見ていて、確認ダイアログが表示されたらすぐタップ。

4. キー取得：Notifyのガイドでログを読む際は Download/wearablelog を選択。中身は解凍済みのログファイルでなければならない。zipのままでは認識されない。

デプロイ

python3 -m venv venv
./venv/bin/pip install 'mcp[cli]<2' uvicorn
cp .env.example .env
# 编辑 .env，填自己的 token（生成：python3 -c "import secrets; print(secrets.token_hex(24))"）

source .env
./venv/bin/python mcp_server.py   # MCP 服务 :8898
./venv/bin/python receiver.py     # 数据接收端 :8899（可选）

ポート8898を開放。データプッシュが必要なら8899も追加。

フロントエンド接続（3つだけでOK）

ツール

データプッシュ

スマホ側のスクリプトがデータを :8899/push に POST する：

curl -X POST http://<服务器>:8899/push \
  -H "Authorization: Bearer $BAND_MCP_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"heart_rate": 76, "steps": 5230, "sleep": {"deep": 92, "light": 401, "total": 493}, "battery": 61}'

Roadmap（デラックス版）

• knock ツール：AI が能動的にノック、ntfy → スマホ通知 → バンド振動（v1 実装済み）

• スマホの自動バックアップ＋プッシュスクリプトをワンクリック設定にパッケージ化

• 健康イベント通知（心拍異常、座位時間の長さ、睡眠サマリーの朝のカード）

謝辞

（棠梦烟が執筆中——資料、落とし穴、方向性、すべて彼女の貢献だ。）

ライセンス

• コード：AGPL-3.0（LICENSE 参照）——誰でも使って改造できるが、改造後もオープンソースにしなければならない。サービスとして運用する場合もオープンソース必須。商用クローズドソースは絶対に不可。

• ドキュメントと設計思想：CC BY-NC-SA 4.0——共有・改変は可能だが、非商用で、かつ同一条件で共有する必要がある。

オープンソースなのは「橋」であり、「橋の上を走るもの」ではない。