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 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 reescribe como un servicio Cloudflare Worker + MCP, agradeciendo al proyecto original.

Related MCP server: apple-health-shortcuts-mcp

Despliegue con un clic

El proceso de despliegue requiere vincular Cloudflare KV. Si el flujo del botón solicita crear o seleccionar un namespace de KV, siga las instrucciones y asegúrese 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

Rellene el ID de namespace de la salida del comando en wrangler.toml, reemplazando your-kv-namespace-id. Luego configure el token de acceso y despliegue:

npx wrangler secret put AUTH_TOKEN
npx wrangler deploy

El valor de AUTH_TOKEN debe ser una cadena aleatoria larga generada por usted mismo; no lo escriba en el código fuente, wrangler.toml ni Git.

Configuración posterior al despliegue

1. Cree un namespace de KV:

   npx wrangler kv namespace create MI_HEALTH_KV

2. Rellene el ID de namespace de la salida del comando en [[kv_namespaces]] de wrangler.toml, reemplazando your-kv-namespace-id, y vuelva a desplegar. Con el despliegue con un clic, también puede crear y vincular KV siguiendo las instrucciones del flujo del botón.

3. Configure interactivamente el token de autenticación de MCP. Genere usted mismo una cadena aleatoria larga para el token:

   npx wrangler secret put AUTH_TOKEN

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

   npx wrangler deploy

El nombre del enlace KV debe permanecer como MI_HEALTH_KV.

Configuración del cliente

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

• URL: https://<你的域名>/mcp

• Encabezado personalizado: Authorization: Bearer <你的 token>

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

Flujo de uso

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

2. Use cualquier herramienta de código QR para renderizar loginUrl como código QR.

3. Escanee con la aplicación Xiaomi Sports Health y confirme el inicio de sesión.

4. El cliente sondea health_login_poll hasta que devuelva success.

5. Después de iniciar sesión correctamente, use health_latest, health_sleep, health_heart o health_steps para consultar los datos.

El Worker no genera imágenes de código 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 utiliza la GNU General Public License v3.0 (GPL-3.0), en línea con la licencia del proyecto original Misty02600/mi-fitness-python.