ZeppBridge MCP
MCP-сервер для локальной базы Zepp и Amazfit: агент читает сон, пульс, тренировки и готовит план, данные остаются у вас
- 251 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- Читает личные данные о здоровье: сон, пульс, стресс, кислород крови и маршруты GPS
- Расширенное подключение использует почту или телефон и пароль аккаунта Zepp
- Публикация тренировочного плана на часы доступна при отдельном разрешении и меняет данные на устройстве
Установка
- Работает в
Ручная установка
Сначала убедись, что пользователь уже поставил настольное приложение ZeppBridge, вошел в аккаунт Zepp и хотя бы раз выполнил синхронизацию: CLI и MCP не выполняют вход. Путь к `zeppbridge-mcp` показан в Settings, раздел AI tools. Подключи его как stdio-сервер в MCP-клиенте. Если каталог данных нестандартный, задай `ZEPPBRIDGE_DATA_DIR` абсолютным путем. Планы тренировок только готовь как черновик, на часы без явного разрешения пользователя не отправляй.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Читает личные данные о здоровье: сон, пульс, стресс, кислород крови и маршруты GPS
- Расширенное подключение использует почту или телефон и пароль аккаунта Zepp
- Публикация тренировочного плана на часы доступна при отдельном разрешении и меняет данные на устройстве
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
ZeppBridge это настольное приложение для владельцев часов Zepp и Amazfit. Оно синхронизирует записи с облака Zepp в локальную базу `data/zepp.db`, показывает тренды сна, пульса, нагрузки и тренировок, умеет экспортировать данные и отправлять тренировочные планы на часы. Для агентов к приложению прилагаются два инструмента: `zeppbridge-mcp` и `zeppbridge-cli`. Это тонкие надстройки над общим ядром, они читают ту же базу, что и приложение. MCP дает совместимым клиентам запросы к локальным записям. Данные о здоровье доступны только для чтения, и сервер не обращается к сети. Планы тренировок агент может составить как черновик, а публикация плана на часы требует отдельного разрешения. В репозитории есть плагин `zepp-coach` для коуч-сценария на ваших данных Amazfit. CLI выполняет `status`, `sync`, `reprocess`, `export` и `contract` без вопросов и окон, вывод с флагом `--json` годится для скриптов. На машине без рабочего стола берут архив `zeppbridge-tools-<версия>-<платформа>.zip` из Releases и сверяют его по `SHA256SUMS.txt`. Каталог данных тулзы определяют по своему расположению, поэтому на сервере его задают переменной `ZEPPBRIDGE_DATA_DIR`. Вход в аккаунт Zepp выполняет только настольное приложение.
Для кого. Владельцам часов Zepp и Amazfit, которые хотят разбирать сон, пульс и тренировки с помощью Claude или Cursor, не отправляя сырую выгрузку в облако.
Подходит, если
- Нужен недельный разбор тренировок и восстановления: агент читает сон, HRV и нагрузку из локальной базы
- Беговой план хочется составить с учетом реального пульса и темпа, а затем отправить на часы после вашего подтверждения
- Историю из Zepp стоит сохранить у себя: база хранится на компьютере, есть резервные копии и экспорт в JSON, CSV, GPX и FIT
- Скрипт или планировщик на NAS должен ежедневно выгружать данные командой `zeppbridge-cli export`
- Агенту на сервере без рабочего стола нужны данные: отдельный архив с CLI и MCP работает без интерфейса
Не подходит, если
- Часы другого бренда, например Garmin или Apple Watch: ZeppBridge синхронизирует только записи Zepp и Amazfit
- Приложение Zepp на телефоне не успело загрузить данные с часов: локальная база пополняется только после синхронизации
- Нужен вход через сторонний аккаунт для расширенных метрик: подключение продвинутых данных не поддерживает сторонний вход
- Работа идет на macOS или Linux и нужна полная проверенность: версия V3 там еще не проверена на реальных машинах
Пример запроса к агенту
Через `zeppbridge-mcp` посмотри мои тренировки и сон за последние две недели и предложи черновик бегового плана на следующую неделюMCP
- Транспорт
- stdio
- Авторизация
- не нужна
Переменные окружения
ZEPPBRIDGE_DATA_DIR- Абсолютный путь к каталогу данных, если инструменты лежат не рядом с приложением
Ограничения
- Вход в аккаунт Zepp, включая подключение расширенных данных (HRV, стресс, кислород крови), выполняется только в настольном приложении. Расширенное подключение использует почту или телефон и пароль Zepp.
- Установщики пока без подписи: Windows может показать предупреждение об издателе, macOS может отказаться открыть приложение. Основная платформа разработки Windows, V3 на macOS и Linux не проверена на реальных машинах.
- Набор метрик зависит от часов, облака Zepp и объема авторизации. Отсутствующие данные остаются пустыми, а не заполняются нулями.
- Обновление с версии 2.x необратимо: базу после V3 старая версия не откроет, поэтому копию базы стоит сохранить заранее.
Как отключить. Уберите сервер `zeppbridge-mcp` из конфигурации MCP-клиента. Приложение удаляется обычным образом через установщик системы, а база остается в каталоге данных: ее удаляют вручную, если она больше не нужна.
Частые вопросы
Как подключить ZeppBridge к Claude или Cursor?
Поставьте настольное приложение, войдите в Zepp и дождитесь первой синхронизации. Затем укажите в MCP-клиенте путь к `zeppbridge-mcp`: его показывает раздел Settings, AI tools. Готовой команды установки в README нет.
Какие данные видит агент?
Сон, пульс, HRV, шаги, стресс, тренировки с темпом и маршрутами GPS и недельные отчеты, если часы их измеряют и облако их сохранило. Здоровье доступно только на чтение, а сеть MCP-сервер не использует.
Может ли агент отправить план на часы?
Черновик агент составить может, а прямую публикацию разрешают отдельным правом. Подтверждение вы даете сами, и доставка на часы зависит от модели устройства и состояния синхронизации.
Как запустить CLI и MCP на сервере без рабочего стола?
Скачайте из Releases архив `zeppbridge-tools-<версия>-<платформа>.zip`, проверьте `SHA256SUMS.txt` и задайте `ZEPPBRIDGE_DATA_DIR` на каталог с базой. Вход выполняется только в приложении, поэтому базу и токен переносят отдельно.
Чем ZeppBridge отличается от Garmin MCP?
Он работает с часами Zepp и Amazfit и читает локальную базу, которую сам синхронизирует. Garmin MCP обращается к сервису Garmin Connect.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыStrava MCP
Strava MCP Server
MCP-сервер Strava: агент читает ваши тренировки, пульс, ватты, сегменты и маршруты и выгружает маршруты в GPX и TCX
coros-mcp (сообщество)
coros-mcp
Неофициальный MCP-сервер Coros: сон, HRV, нагрузка и тренировки из Training Hub и планирование занятий в календаре.
MCP-сервер для учета тренировок: Claude Desktop, Cursor и Cline читают программы, подходы, вес тела и 1ПМ из вашего самостоятельно развернутого openGym
Официальный MCP COROS: агент читает тренировки, сон и пульс и составляет планы тренировок, сохраняя их в аккаунт.
MCP-сервер только для чтения: восстановление, сон, HRV, нагрузка и тренировки из WHOOP в Claude, Codex и Cursor.
Агент читает сон, активность и пульс из Fitbit и Pixel Watch через OAuth, а токены хранятся только на вашем компьютере.
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| ZeppBridge (эта карточка) | нет | не нужна | 251 | |
| Garmin MCP | нет | API-ключ | 1 498 | данные Garmin Connect через неофициальную библиотеку, а ZeppBridge работает с часами Zepp и Amazfit и локальной базой |
| Apple Health MCP Server | нет | не нужна | 575 | читает выгрузку Apple Health запросами SQL, а здесь база Zepp синхронизируется сама и есть планы тренировок |
Коротко о README
Страница описывает приложение по разделам: обзор метрик, разговор с ИИ через файл Markdown, превращение ответа в недельный тренировочный план и отправка на часы. Затем объясняет хранение данных, резервные копии, экспорт и подключение собственных инструментов через MCP, CLI и локальный REST API. Дальше идут установка на Windows, macOS и Linux, первое подключение к Zepp и расположение данных.