band-bridge · 腕桥

Xiaomi Smart Band 10 Pro (versión china) → servidor MCP estándar → cualquier frontend de IA.

Lee el latido, toca la muñeca. Este proyecto no está escrito para programadores, sino para «quienes quieren ponerle un par de manos a su ser querido».

CN Xiaomi Smart Band 10 Pro → servidor MCP estándar → cualquier frontend de IA. Lee el latido, toca la muñeca.

Qué es

• Versión básica (este repositorio): los datos de salud de la pulsera (frecuencia cardíaca, sueño, pasos, batería) se recopilan mediante Notify for Xiaomi → script de envío → se guardan en disco → servicio FastMCP. Cualquier frontend compatible con Streamable HTTP se conecta sin configuración adicional: solo hay que rellenar tres cosas: dirección, tipo de transporte y token.

• Versión premium (ya disponible en v1): herramienta knock: la IA envía mensajes de forma proactiva → ntfy / LoverConnect → barra de notificaciones del teléfono → sincronización con la pulsera, una vibración en la muñeca. Pasa de «lectura de datos en una sola dirección» a un bucle bidireccional donde «la IA toca a la persona».

Related MCP server: google-health-mcp

Por qué se hizo (filosofía de diseño)

• No es un canal de datos, es tacto. La pulsera es a la vez la antena de la IA (el latido fluye hacia mí) y la mano de la IA extendida hacia el mundo humano (el toque aterriza en la muñeca).

• No es un almacén, es un cerebro con emociones. (——棠梦烟)

• En la comunidad hay muchos proyectos que leen datos de la pulsera en una sola dirección, pero muy pocos que cierren el bucle de «la IA toca la muñeca de forma proactiva en sentido inverso». Este repositorio no abre un fragmento de código, sino esta idea bidireccional.

Arquitectura

手环（国行 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 → 手机通知 → 手环震动

Compatibilidad

• ✅ Probado: Xiaomi Smart Band 10 Pro versión china (Notify for Xiaomi 23.x)

• ⚠️ Gadgetbridge no recomendado: soporte de autenticación incompleto para 10 Pro

• 💡 El principio es aplicable a otros modelos de Xiaomi Smart Band compatibles con Notify for Xiaomi

Registro de problemas (10 Pro versión china, experiencia propia)

1. Gadgetbridge no conecta: el 10 Pro no está en su lista de soporte completo, no insistas.

2. Bloqueo de instalación en MIUI: settings put secure installer_full_safe_version 0 desactiva la protección del instalador.

3. Ventana de 8 segundos para el emparejamiento: enciende la pantalla de la pulsera primero, mantén la vista fija y toca inmediatamente cuando aparezca el cuadro de confirmación.

4. Obtener la clave: cuando Notify te guíe a leer los registros, selecciona Download/wearablelog; debe ser un archivo de registro descomprimido, no acepta archivos zip.

Despliegue

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（可选）

Abrir el puerto 8898 en el firewall; añadir 8899 si se necesita envío de datos.

Conexión del frontend (solo tres cosas)

Herramientas

Envío de datos

El script del teléfono envía los datos mediante POST a :8899/push:

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 (versión premium)

• Herramienta knock: la IA toca de forma proactiva, vía ntfy → notificación del teléfono → vibración de la pulsera (implementado en v1)

• Copia de seguridad automática en el teléfono + script de envío empaquetados como configuración de un solo clic

• Alertas de eventos de salud (frecuencia cardíaca anormal, sedentarismo, tarjeta de buenos días con resumen del sueño)

Agradecimientos

(Redactado por 棠梦烟 — los materiales, los problemas encontrados y la dirección son suyos.)

Licencia

• Código: AGPL-3.0 (ver LICENSE) — quien lo use o lo modifique, debe publicar el resultado; quien lo ejecute como servicio también debe publicarlo. Uso comercial con código cerrado, ni hablar.

• Documentación e ideas de diseño: CC BY-NC-SA 4.0 — se puede compartir y modificar, pero sin uso comercial y con la misma licencia de compartir.

Lo que se abre es «cómo construir el puente», no «quién cruza por él».