mi-health-mcp

Resumen del proyecto

mi-health-mcp expone los datos de familiares y amigos de Xiaomi Sports Health, incluyendo sueño, frecuencia cardíaca y pasos, a clientes LLM como RikkaHub a través del protocolo MCP. El servicio se ejecuta en Cloudflare Workers, sin necesidad de montar un servidor propio, y se puede usar dentro de la cuota gratuita de Cloudflare. Este proyecto se basa en la ingeniería inversa de la interfaz de Misty02600/mi-fitness-python y se ha reescrito como un servicio Cloudflare Worker + MCP. Gracias al proyecto original.

Related MCP server: Health Vault

Despliegue con un clic

El proceso de despliegue requiere vincular Cloudflare KV. Si el flujo del botón solicita crear o seleccionar un namespace KV, sigue las instrucciones y asegúrate de que el enlace se llame MI_HEALTH_KV.

Despliegue manual si el botón no funciona

Se requiere Node.js 20 o superior y una cuenta de 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

Rellena el ID del namespace que devuelve el comando en wrangler.toml, reemplazando your-kv-namespace-id. Luego configura el token de acceso y despliega:

npx wrangler secret put AUTH_TOKEN
npx wrangler deploy

El valor de AUTH_TOKEN debe ser una cadena aleatoria larga generada por ti. No lo escribas en el código fuente, en wrangler.toml ni en Git.

Configuración posterior al despliegue

1. Crea un namespace KV:

   npx wrangler kv namespace create MI_HEALTH_KV

2. Rellena el ID del namespace que devuelve el comando en [[kv_namespaces]] de wrangler.toml, reemplazando your-kv-namespace-id, y vuelve a desplegar. Si usas el despliegue con un clic, también puedes crear y vincular el KV siguiendo las instrucciones del flujo del botón.

3. Configura interactivamente el token de autenticación de MCP. Genera un token largo aleatorio:

   npx wrangler secret put AUTH_TOKEN

4. Vuelve a desplegar cuando haya cambios en la configuración:

   npx wrangler deploy

El nombre del enlace KV debe mantenerse como MI_HEALTH_KV.

Configuración del cliente

En RikkaHub, abre «Configuración > MCP > Nueva conexión > Streamable HTTP» y completa:

• URL: https://<tu dominio>/mcp

• Encabezado personalizado: Authorization: Bearer <tu token>

El <tu token> debe coincidir exactamente con el AUTH_TOKEN configurado durante el despliegue.

Flujo de uso

1. El cliente llama primero a health_login_start para obtener loginUrl.

2. Usa cualquier herramienta de códigos QR para renderizar loginUrl como un código QR.

3. Escanea el código con la app Xiaomi Sports Health y confirma el inicio de sesión.

4. El cliente sondea health_login_poll hasta que devuelva success.

5. Una vez iniciada la sesión, usa health_latest, health_sleep, health_heart o health_steps para consultar los datos.

El Worker no genera imágenes de códigos QR. Al consultar, lee dinámicamente la lista de familiares y amigos y usa el primer elemento; no se fija el ID de usuario en el código.

Límites de uso

Solo para iniciar sesión con tu propia cuenta de Xiaomi y consultar los datos de familiares y amigos que hayas autorizado. No lo uses para infringir la privacidad de otros ni para violar el acuerdo de usuario de Xiaomi.

Licencia

Este proyecto se distribuye bajo la GNU General Public License v3.0 (GPL-3.0), en línea con la licencia del proyecto original Misty02600/mi-fitness-python.