garmin-local-mcp — MCP-сервер для Claude Code: запуск и обзор
Сохраняет показатели Garmin в локальную базу SQLite для анализа трендов здоровья. Агент изучает сон и пульс офлайн, не расходуя контекст на тяжёлые ответы API.
claude mcp add --env GARMIN_MCP_DATA_DIR=<GARMIN_MCP_DATA_DIR> --transport stdio garmin-local-mcp -- uvx garmin-local-mcpЧто делает garmin-local-mcp
Сервер скачивает историю Garmin Connect в локальную директорию: неизменяемые снимки JSON и структурированную базу SQLite. Вместо отправки сотен килобайтов сырого JSON ассистент получает компактные таблицы размером до 2 КБ. Набор из 13 инструментов вычисляет базовые линии, сканирует корреляции со сдвигом от -7 до +7 дней и находит провалы в замерах.
Для запуска требуется окружение Python 3.12+. Если аккаунта Garmin нет, команда demo генерирует синтетический массив на 180 дней со скрытыми закономерностями вроде периодов недомогания и смещения хронотипа. Локальное хранилище спасает при сбоях авторизации на стороне сервиса: база продолжает отвечать на запросы, а свежие данные можно импортировать напрямую из файлов FIT без логина и пароля.
Какие задачи решает
- рассчитать корреляцию нагрузки и пульса покоя со сдвигом по дням
- оценить индивидуальный хронотип по фазам и продолжительности сна
- выявить аномалии в самочувствии без передачи сотен килобайт логов модели
- загрузить метрики здоровья из резервной копии FIT без авторизации
Примеры запросов агенту
- Посчитай корреляцию между тренировочным объёмом и пульсом покоя со сдвигом на следующий день.
- Найди пропуски и аномальные значения в замерах вариабельности сердечного ритма за полгода.
- Определи мой хронотип по истории сна и проверь надёжность оценки.
Как установить garmin-local-mcp
Командой платформы
claude mcp add --env GARMIN_MCP_DATA_DIR=<GARMIN_MCP_DATA_DIR> --transport stdio garmin-local-mcp -- uvx garmin-local-mcpВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from garmin-local-mcp <команда>
Командой платформы
codex mcp add garmin-local-mcp --env GARMIN_MCP_DATA_DIR=<GARMIN_MCP_DATA_DIR> -- uvx garmin-local-mcpВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from garmin-local-mcp <команда>
Файл настроек
{
"mcpServers": {
"garmin-local-mcp": {
"command": "uvx",
"args": [
"garmin-local-mcp"
],
"env": {
"GARMIN_MCP_DATA_DIR": "<GARMIN_MCP_DATA_DIR>"
}
}
}
}Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from garmin-local-mcp <команда>
Файл настроек
{
"servers": {
"garmin-local-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"garmin-local-mcp"
],
"env": {
"GARMIN_MCP_DATA_DIR": "<GARMIN_MCP_DATA_DIR>"
}
}
}
}Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from garmin-local-mcp <команда>
Командой платформы
gemini mcp add -e GARMIN_MCP_DATA_DIR=<GARMIN_MCP_DATA_DIR> garmin-local-mcp uvx garmin-local-mcpВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from garmin-local-mcp <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о garmin-local-mcp
Как установить garmin-local-mcp в Claude Code?
Выполните команду claude mcp add garmin-local-mcp -- uvx garmin-local-mcp в терминале. Если хотите указать собственную папку для базы данных, передайте переменную окружения: claude mcp add --env GARMIN_MCP_DATA_DIR=<GARMIN_MCP_DATA_DIR> --transport stdio garmin-local-mcp -- uvx garmin-local-mcp.
Зачем нужен локальный склад вместо прямых запросов к Garmin?
Прямые вызовы неофициального API отдают сотни килобайтов избыточных данных на каждый запрос сна. Локальная база SQLite выполняет расчёты на вашем компьютере и отдаёт агенту сжатые сводки размером менее 2 КБ.
Можно ли протестировать инструменты без учётной записи Garmin?
Да, встроенная команда demo наполняет локальную базу синтетической историей за 180 дней. Модель получает реалистичные метрики сна, скрытый хронотип и смоделированные сбои пульса для проверки аналитических функций.
