Garmin Connect China MCP

Локальный MCP-сервер только для чтения для учетной записи Garmin Connect китайского региона. Каждый клиент Garmin жестко привязан к garmin.cn; чтение API выполняется через https://connectapi.garmin.cn и соответствующие китайские хосты SSO/DI-auth.

Здесь используется неофициальный потребительский веб-API Garmin Connect через garminconnect. Он подходит для личного частного использования, может перестать работать при изменении сервисов Garmin и не заменяет одобренный Garmin Health API для коммерческих продуктов.

Требования

• Python 3.12+

• uv

• Учетная запись Garmin Connect Китай

Related MCP server: health-mcp

Установка и аутентификация

Из этого каталога:

uv sync
uv run garmin-cn-auth

Команда аутентификации запрашивает email, пароль и MFA прямо в терминале. Пароли и коды MFA никогда не становятся аргументами MCP. Обновляемые токены по умолчанию хранятся в ~/.config/garmin-cn-mcp/ с правами только для владельца.

Относитесь к этому каталогу токенов как к паролю. Если он мог быть скопирован, удалите его и отзовите доступ к учетной записи в настройках учетной записи/безопасности Garmin.

Добавление в Codex / ChatGPT desktop

С Codex CLI:

codex mcp add garmin-cn -- \
  uv --directory /absolute/path/to/garmincn-mcp run garmin-cn-mcp

Или добавьте это в ~/.codex/config.toml:

[mcp_servers.garmin-cn]
command = "uv"
args = [
  "--directory",
  "/absolute/path/to/garmincn-mcp",
  "run",
  "garmin-cn-mcp",
]
startup_timeout_sec = 20
tool_timeout_sec = 60

Приложение ChatGPT desktop, Codex CLI и расширение Codex IDE используют общую конфигурацию MCP для одного и того же хоста Codex. В ChatGPT desktop вы также можете открыть Settings → MCP servers → Add server, выбрать STDIO и использовать ту же команду. Перезапустите клиент после добавления, затем используйте /mcp, чтобы убедиться, что garmin-cn подключен.

ChatGPT web не читает локальную конфигурацию Codex MCP. Для веб-использования потребуется отдельно размещенный удаленный MCP/плагин с многопользовательской авторизацией и дизайном конфиденциальности; это намеренно выходит за рамки данного проекта.

Инструменты

• get_connection_status

• get_daily_summary

• get_sleep

• get_heart_rate

• get_hrv

• get_training_readiness

• get_morning_training_readiness

• get_body_battery

• list_activities

• get_activity_details

• get_activity_exercise_sets

• get_activity_supplementary

Каждый инструмент доступен только для чтения и не является разрушительным. Диапазоны дат ограничены 31 днем, списки активностей — 100 результатами. Не предоставляется ни один инструмент для записи с необработанными путями API или Garmin.

Пользовательский путь к хранилищу токенов

Установите GARMIN_CN_TOKEN_STORE для процессов аутентификации и MCP, или передайте --token-store любой из команд. Держите путь вне репозитория Git.

Проверки разработки

uv sync --group dev
uv run pytest
uv run ruff check .
uv run mypy

Тесты используют фиктивные провайдеры и никогда не связываются с Garmin.