mi-health-mcp
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: mi-health-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_KVRellene 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 deployEl 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
Cree un namespace de KV:
npx wrangler kv namespace create MI_HEALTH_KVRellene el ID de namespace de la salida del comando en
[[kv_namespaces]]dewrangler.toml, reemplazandoyour-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.Configure interactivamente el token de autenticación de MCP. Genere usted mismo una cadena aleatoria larga para el token:
npx wrangler secret put AUTH_TOKENVuelva 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://<你的域名>/mcpEncabezado personalizado:
Authorization: Bearer <你的 token>
El <你的 token> debe coincidir exactamente con el AUTH_TOKEN configurado durante el despliegue.
Flujo de uso
El cliente primero llama a
health_login_startpara obtenerloginUrl.Use cualquier herramienta de código QR para renderizar
loginUrlcomo código QR.Escanee con la aplicación Xiaomi Sports Health y confirme el inicio de sesión.
El cliente sondea
health_login_pollhasta que devuelvasuccess.Después de iniciar sesión correctamente, use
health_latest,health_sleep,health_heartohealth_stepspara 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.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
Hosted Apple Health MCP for Claude and ChatGPT, works outside the US. iPhone app, no local server.
Hosted Apple Health MCP: workouts, sleep and HRV in ChatGPT, Claude, Gemini, Grok. Free, no export.
Remote streamable-HTTP MCP server running on a single Cloudflare Worker. Your assistant gets live Airbnb, Amazon, Booking.com, Google Flights, Maps and Reddit data, social search on X, Instagram and TikTok, the Meta Ad Library, and image/video generation without any keys. Connect your own accounts to let it send WhatsApp or Telegram messages, work an IMAP inbox, manage Meta Ads campaigns and publish to X and LinkedIn. OAuth 2.1 with PKCE; stored credentials are AES-256-GCM encrypted.
MCP server for Withings health data — sleep, activity, heart, and body metrics.
Related MCP Servers
- AlicenseNot gradedqualityNot gradedmaintenanceEnables LLM clients to access authorized Xiaomi Mi Fitness health data, including sleep, heart rate, and steps, through an MCP server deployed on Cloudflare Workers.GPL 3.0
- AlicenseNot gradedqualityNot gradedmaintenanceExposes Xiaomi Mi Fitness family health data — sleep, heart rate, and step counts — to LLM clients over the MCP protocol. Runs on Cloudflare Workers with QR-code login and token-based authentication, requiring no self-hosted server.GPL 3.0
- AlicenseNot gradedqualityNot gradedmaintenanceEnables LLM clients to authenticate with Xiaomi Health and query authorized family members' sleep, heart rate, and step data via MCP, with deployment on Cloudflare Workers.GPL 3.0
- AlicenseNot gradedqualityNot gradedmaintenanceEnables LLM clients to authenticate with Xiaomi Mi Fitness and query authorized family or friends' sleep, heart rate, and step data through the MCP protocol, deployable on Cloudflare Workers.GPL 3.0