mi-health-mcp

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

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

Related MCP server: apple-health-shortcuts-mcp

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

Процесс развёртывания требует привязки 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.