Skip to main content
Glama
deenesjakoruzh
nnishad

health-relay

by nnishad
OverviewSchemaRelated ServersScoreDiscussions
Python
Hybrid

health-relay

Мост между вашим приложением на телефоне Samsung Watch → Sync2Ra1 и вашим ИИ-агентом Hermes. Приложение отправляет показания здоровья сюда по вашей локальной сети; данные хранятся локально (SQLite) и доступны через REST и MCP, чтобы ваш агент мог запрашивать их.

Galaxy Watch ─▶ Samsung Health ─▶ Sync2Ra1 (phone) ──push──▶ health-relay ──MCP/REST──▶ Hermes

Все данные остаются в вашей сети. Ничего не передаётся за её пределы.

Быстрый старт (Docker или Podman)

echo "HR_AUTH_TOKEN=<choose-a-secret>" > .env
docker compose up -d          # or: podman compose up -d
curl http://localhost:8790/healthz     # -> {"ok":true}

Данные сохраняются в ./data/ledger.db (SQLite, режим WAL).

Запуск без Docker

python3 -m venv .venv && .venv/bin/pip install -r requirements.txt
HR_AUTH_TOKEN=<secret> ./run.sh

Настройка приложения на телефоне

В Sync2Ra1 → вкладка Data → Relay (мост Hermes):

Поле

Значение

URL ретранслятора

http://<this-machine-ip>:8790

Токен

тот же секрет, что и HR_AUTH_TOKEN

Нажмите Save → Sync now. Показания появятся в течение нескольких секунд.

Сетевое взаимодействие

phone (Sync2Ra1) ──HTTP :8790──▶ health-relay ◀──MCP stdio / HTTP── Hermes
        same LAN · or Tailscale for anywhere-access

Правило

Подробности

Направление

Телефон → ретранслятор (только исходящее из телефона; внутрь телефона ничего не подключается)

Порт

TCP 8790, входящий на машину с ретранслятором, — откройте его в файерволе этого хоста

Протокол

Обычный HTTP + Authorization: Bearer <token>. Держите его только в локальной сети либо спрячьте за обратным прокси (Caddy/nginx) для TLS

Доступ извне

Установите Tailscale на машину и телефон; укажите приложению Tailscale-IP (http://100.x.y.z:8790) — трафик шифруется, работает через мобильную сеть, порты в интернет не открываются

Периодичность

Приложение автоматически синхронизируется каждый час, при запуске и вручную через Sync now

Офлайн

Телефон буферизует всё в локальной SQLite; при восстановлении связи он отправляет всю накопленную очередь (сначала самые старые) и заново синхронизирует последние 48 часов, чтобы правки распространились

Дубликаты

Двойной подсчёт невозможен: у каждого показания уникальный ключ; повторные отправки игнорируются на сервере

Место Hermes

На той же машине (MCP работает как локальный подпроцесс и читает файл SQLite) или удалённо (тогда используйте REST API вместо MCP)

REST API (Bearer-авторизация)

Endpoint

Назначение

GET /healthz

проверка жизни сервиса (без авторизации)

POST /api/v1/health/samples

пакетная загрузка — идемпотентно, повторы не дают эффекта

GET /api/v1/health/samples?type=&from_ms=&to_ms=&limit=&offset=

сырые показания

GET /api/v1/health/daily-summary?date=YYYY-MM-DD&tz=Europe/London

по каждому показателю: минимум/максимум/среднее/количество

GET /api/v1/health/trends?type=X&days=N&tz=Europe/London

суточные сводки

GET /api/v1/health/status

итоги по типам

curl -H "Authorization: Bearer <secret>" \
  "http://localhost:8790/api/v1/health/daily-summary?date=$(date +%F)&tz=Europe/London"

Подключение Hermes (MCP)

MCP-сервер читает тот же файл SQLite — запустите его из этого репозитория:

python3 -m venv .venv-mcp
.venv-mcp/bin/pip install fastmcp

Добавьте в конфигурацию MCP вашего агента:

{
  "mcpServers": {
    "health-relay": {
      "command": "<repo-path>/.venv-mcp/bin/python",
      "args": ["<repo-path>/mcp_server.py"],
      "env": { "HR_DATA_DIR": "<repo-path>/data" }
    }
  }
}

Инструменты, которые получает ваш агент

Инструмент

Отвечает на вопросы вроде

list_streams()

«какие данные о здоровье у вас есть?»

get_samples(type, from_ms, to_ms)

«покажи мой пульс этим утром»

daily_summary(date, tz)

«какая у меня была активность вчера?»

sleep_breakdown(nights)

«как я спал на этой неделе?»

Границы суток зависят от вашего часового пояса (tz="Europe/London" и т.д., переход на летнее время учитывается).

Записываемые данные

Пульс · SpO₂ · температура кожи · частота дыхания · пульс в покое · VO₂max · длительность/оценка/стадии сна · шаги и этажи (по часам и по дням) · тренировки · время/каллории/дистанция активности · состав тела (BIA) · показатель энергии · артериальное давление · глюкоза · гидратация · приёмы пищи.

Конфигурация

Переменная

По умолчанию

Это

HR_AUTH_TOKEN

(пусто = авторизация отключена)

задайте в производственной среде (prod)

HR_PORT

8790

HR_HOST

0.0.0.0

оставьте в надёжной локальной сети

HR_DATA_DIR

~/health-relay-data

здесь хранится SQLite

Тесты

.venv/bin/python -m pytest tests/ -q

This server cannot be installed

-
license - not tested
Not graded
quality - not tested
B
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
–Release cycle
–Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Connectors

  • anythingmcp

    Self-hosted MCP gateway: turn any API, database or MCP server into AI connectors — no code.

  • Withings Health Data

    MCP server for Withings health data — sleep, activity, heart, and body metrics.

  • Wellness Project

    63 tools for Apple Health, Fitbit, Oura & Health Connect data in Claude, ChatGPT, Grok & Mistral.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/nnishad/health-relay'

If you have feedback or need assistance with the MCP directory API, please join our Discord server