Garmin Connect China MCP

중국 지역 Garmin Connect 계정용 로컬 읽기 전용 MCP 서버입니다. 모든 Garmin 클라이언트는 garmin.cn에 하드 잠금되어 있으며, API 읽기는 https://connectapi.garmin.cn 및 해당 중국 SSO/DI-auth 호스트로 전송됩니다.

이 도구는 garminconnect를 통해 Garmin Connect의 비공식 소비자 웹 API를 사용합니다. 개인적인 용도로 적합하며, Garmin이 서비스를 변경하면 작동이 중단될 수 있고, 상업용 제품의 승인된 Garmin Health API를 대체하지 않습니다.

요구 사항

• Python 3.12+

• uv

• Garmin Connect 중국 계정

Related MCP server: health-mcp

설치 및 인증

이 디렉터리에서:

uv sync
uv run garmin-cn-auth

인증 명령은 터미널에서 이메일, 비밀번호, MFA를 직접 입력하라는 메시지를 표시합니다. 비밀번호와 MFA 코드는 절대 MCP 인수가 되지 않습니다. 갱신 가능한 토큰은 기본적으로 ~/.config/garmin-cn-mcp/ 아래에 소유자 전용 권한으로 저장됩니다.

토큰 디렉터리를 비밀번호처럼 취급하세요. 복사되었을 가능성이 있다면 삭제하고 Garmin의 계정/보안 설정에서 계정 접근을 해지하세요.

Codex / ChatGPT 데스크톱에 추가

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 데스크톱 앱, Codex CLI, Codex IDE 확장은 동일한 Codex 호스트에 대해 MCP 구성을 공유합니다. ChatGPT 데스크톱에서도 Settings → MCP servers → Add server를 열고 STDIO를 선택한 후 동일한 명령을 사용할 수 있습니다. 추가한 후 클라이언트를 다시 시작하고 /mcp를 사용하여 garmin-cn이 연결되었는지 확인하세요.

ChatGPT 웹은 로컬 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 쓰기 도구는 노출되지 않습니다.

사용자 지정 토큰 저장 경로

인증 및 MCP 프로세스 모두에 GARMIN_CN_TOKEN_STORE를 설정하거나 두 명령에 --token-store를 전달하세요. 경로는 Git 저장소 외부에 유지하세요.

개발 검사

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

테스트는 가짜 공급자를 사용하며 Garmin에 절대 연결하지 않습니다.