Sport Health MCP

Локально-ориентированный MCP-сервер для анализа Huawei Health. Пользователю достаточно один раз предоставить пакет личных данных HUAWEI_HEALTH_*, и агент сможет читать показатели тренировок, физиологические метрики внутри тренировки, контекст здоровья до и после тренировок, а также по запросу дополнять их исторической погодой и качеством воздуха.

Проект предназначен для анализа и разбора тренировок и не предоставляет медицинских диагнозов или рекомендаций по лечению.

Текущие возможности

• Распознавание каталогов экспорта личных данных Huawei и основных JSON-файлов.

• Устойчивый анализ нестандартных JSON-ключей с числами от Huawei.

• Разбор сводки тренировки, GPS-трека, пульса, каденса, скорости, высоты и тренировочной нагрузки.

• Агрегирование данных о пульсе, пульсе в покое, HRV, стрессе, насыщении крови кислородом и фазах сна за день до, в день и на следующий день после тренировки.

• Вызов API исторической погоды и качества воздуха Open-Meteo с локальным кэшированием ответов.

• Постраничные инструменты для работы с данными и пакет доказательств для отчётов.

Related MCP server: Apple Health MCP

Монтаж

Рекомендуется Python 3.11 или новее, а также создание виртуального окружения в каталоге проекта:

python -m venv .venv
.\.venv\Scripts\Activate.ps1
python -m pip install -e ".[dev]"

Экспортные пакеты Huawei не упаковываются и не отправляются в репозиторий: .gitignore по умолчанию игнорирует все каталоги HUAWEI_HEALTH_*.

Локальная проверка

Если в каталоге проекта есть только одна папка HUAWEI_HEALTH_*, она распознаётся автоматически:

sport-health-inspect inspect
sport-health-inspect list

Можно также указать явно:

sport-health-inspect --export-dir "D:\HealthData\HUAWEI_HEALTH_xxx" list

Запуск MCP-сервера

Для локального агента рекомендуется режим stdio:

$env:SPORT_HEALTH_EXPORT_DIR="D:\HealthData\HUAWEI_HEALTH_xxx"
sport-health-mcp

Основная форма конфигурации MCP-клиента следующая; фактические имена полей определяются клиентом:

{
  "mcpServers": {
    "sport-health": {
      "command": "C:\\sport-health-mcp\\.venv\\Scripts\\sport-health-mcp.exe",
      "env": {
        "SPORT_HEALTH_EXPORT_DIR": "D:\\HealthData\\HUAWEI_HEALTH_xxx"
      }
    }
  }
}

Регистрация в MCP-клиенте

В клиенте, поддерживающем MCP stdio, добавьте конфигурацию с command и env, как указано выше, сохраните изменения и перезапустите клиент. Расположение конфигурационных файлов и внешних полей в различных клиентах может отличаться — ориентируйтесь на документацию соответствующего клиента.

Использование с разными агентами

• На этом же компьютере: каждый агент, поддерживающий MCP stdio, может запускать один и тот же сервер, но требуется зарегистрировать его в формате этого агента.

• На другом компьютере: установите этот проект, экспортируйте свой пакет данных HUAWEI_HEALTH_* и замените команду и каталог данных в конфигурации на свои абсолютные пути.

• Для веб-агентов или облачных агентов: к локальному процессу stdio на компьютере пользователя доступа нет. Чтобы поддерживать такие клиенты, требуется отдельно развернуть защищённый Streamable HTTP сервер с аутентификацией, а также проработать шифрование загрузки, изоляцию пользователей, удаление данных и механизмы соответствия требованиям конфиденциальности.

Проект не делится авторскими пакетами данных экекипаций Huawei. MCP-сервер — это универсальная программа; данные каждого пользователя остаются на его собственном компьютере.

Инструменты MCP

• inspect_huawei_export - проверяет целостность пакета данных.

• list_activities - выводит список тренировок.

• get_activity_summary - получает сводку по одной тренировке.

• get_activity_track - постранично выдаёт GPS-трек.

• get_activity_samples - постранично выдает образцы пульса, каденса, скорости и высоты.

• get_health_context - получает интервалы врёмён многодневный контекст здоровья до и после тренировки.

• get_activity_environment - получает и кэширует исторические данные об окружающей среде.

• get_report_evidence_pack - создаёт детерминированный пакет данных для написания отчёта роверки.

• get_report_contract - выдает фиксированную структуру отчёта, лимит объёма и требования к написанию.

Перед выполнением заданий агента следует вызывать list_activities, после выбора activity_id в первую очередь вызывать get_report_evidence_pack и строгий руководствоваться его автоданными format model, возвращённым report_contract, при генерации отчёта. Форматированный шаблон включает только ключевые выводы, анализ результатов, реакцию организма и рекомендации по тренировкам, чтобы избегать дублирования всех показателей, которые уже отображаться в приложении устройства. Постраничные детализированные инструменты используются только тогда, когда требуется посмотреть исходные графики или трек.

Тестирование

Для запуска тестов на основе стандартной библиотеки не требуется устанавливать тестовую селку:

$env:PYTHONPATH="src"
python -m unittest discover -s tests -v

Тесты используются только искусственные записи тренировок, сгенерированные кодом, и не зависят от личных данных и не содержат их.

Приватность и границы конфиденциальности

• Исходные данные о здоровье по умолчанию считываются только локально.

• Только инструмент улучшения окружения обращается к сети и отправляет лишь центра рамки, дату и часовой диапазон.

• Инструменты MCP работают только на чтение и не изменяют экспортные файлы Huawei.

• Перед публикацией журналов или отчётов об ошибках удалите координаты, время, identity устройств и показатели здоровья.

• Перед публикацией исходного кода не архивируйте целиком рабочий каталог напрямую; для публикуйте через экспорт управления версиями или артефакты сборки, чтобы не включить в состав случайно уже проигнорированные каталоги личных данных.

Открытое лицензирование

Проект распространяется под лицензией MIT License. Перед отправкой отчёта о безопасности, обязательно прочитайте SECURITY.md. Не загружайте в публичные Issue настоящие данные о здоровье, GPS-трекифологических данных, кэш окружения или журналы с локальными путями.

Сторонние службы и товарные знаки

• Экологические данные предоставляются Open-Meteo, данные распространяees по лицензии CC BY 4.0, при отображении необходимо указывать источник и сохранить статус лицензии.

• Бесплатный API Open-Meteo разрешён только для некоммерческого использования и подчиняется квотным образам призыва. Для коммерческого использования следует использовать их премиальный интерфейс или развернуть собственный сервес в соответствии с офециальной лицензией; подробности — Open-Meteo Terms.

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