mi-health-mcp

Описание проекта

mi-health-mcp предоставляет данные о близких из Mi Fitness (Xiaomi Sports & Health), включая сон, частоту сердечных сокращений и количество шагов, LLM-клиентам, таким как RikkaHub, через протокол MCP. Сервис работает на Cloudflare Workers, не требует собственного сервера и может использоваться в рамках бесплатного лимита Cloudflare. Этот проект основан на результатах обратной разработки интерфейсов из Misty02600/mi-fitness-python и переписан как Cloudflare Worker + MCP-сервис. Благодарим вышестоящий проект.

Related MCP server: Health Vault

Развёртывание в один клик

Процесс развёртывания требует привязки Cloudflare KV. Если мастер-кнопка предложит создать или выбрать KV namespace, следуйте подсказкам и убедитесь, что привязка называется MI_HEALTH_KV.

Ручное развёртывание, если кнопка не работает

Требуется Node.js 20 или новее, а также учётная запись 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

Вставьте namespace ID из вывода команды в wrangler.toml, заменив your-kv-namespace-id. Затем задайте токен доступа и выполните развёртывание:

npx wrangler secret put AUTH_TOKEN
npx wrangler deploy

Для значения AUTH_TOKEN используйте собственную длинную случайную строку. Не записывайте её в исходный код, wrangler.toml или Git.

Настройка после развёртывания

1. Создайте KV namespace:

   npx wrangler kv namespace create MI_HEALTH_KV

2. Вставьте namespace ID из вывода команды в [[kv_namespaces]] в wrangler.toml, заменив your-kv-namespace-id, затем выполните повторное развёртывание. При развёртывании в один клик KV также можно создать и привязать по подсказкам мастера.

3. Интерактивно задайте токен аутентификации MCP. Сгенерируйте собственную длинную случайную строку:

   npx wrangler secret put AUTH_TOKEN

4. При изменении конфигурации выполните повторное развёртывание:

   npx wrangler deploy

Имя привязки KV должно оставаться MI_HEALTH_KV.

Настройка клиента

В RikkaHub откройте «Настройки > MCP > Новое подключение > Streamable HTTP» и заполните:

• URL: https://<ваш-домен>/mcp

• Пользовательский заголовок: Authorization: Bearer <ваш-токен>

Значение <ваш-токен> должно полностью совпадать с AUTH_TOKEN, заданным при развёртывании.

Порядок использования

1. Клиент сначала вызывает health_login_start и получает loginUrl.

2. С помощью любого инструмента для QR-кодов отобразите loginUrl в виде QR-кода.

3. Отсканируйте код приложением Mi Fitness и подтвердите вход.

4. Клиент периодически вызывает health_login_poll, пока не получит success.

5. После успешного входа запрашивайте данные с помощью health_latest, health_sleep, health_heart или health_steps.

Worker не генерирует изображения QR-кодов. При запросе список близких считывается динамически и используется первый элемент; идентификатор пользователя не зашит в код.

Границы использования

Только для входа в вашу собственную учётную запись Xiaomi и запроса данных о близких, на которые вы получили разрешение. Не используйте проект для нарушения чьей-либо конфиденциальности или в целях, противоречащих пользовательскому соглашению Xiaomi.

Лицензия

Этот проект распространяется под GNU General Public License v3.0 (GPL-3.0), что соответствует лицензии вышестоящего проекта Misty02600/mi-fitness-python.