Taxuspt/garmin_mcp

해결하는 문제

이 프로젝트는 AI 어시스턴트(Claude와 같은)가 Garmin Connect와 상호작용할 수 있도록 하는 Model Context Protocol (MCP) 서버를 제공합니다. 이는 사용자의 피트니스 및 건강 데이터와 LLM 사이의 간격을 메워주어, 채팅 인터페이스 내에서 직접 운동을 분석하고, 건강 지표를 추적하며, 심지어 훈련 계획을 생성하고 일정을 예약할 수 있게 해줍니다.

작동 방식

서버는 MCP 호환 클라이언트와 Garmin Connect API(python-garminconnect 라이브러리 사용) 사이의 중개자 역할을 합니다. AI가 데이터를 가져오거나 작업을 수행하기 위해 호출할 수 있는 110개 이상의 도구를 노출합니다. 로컬 클라이언트를 위한 표준 입출력(stdio) 및 원격 배포를 위한 HTTP/SSE를 포함한 여러 전송 방식을 지원합니다.

대상 사용자

AI를 사용하여 건강 데이터를 분석하고, 훈련 일정을 관리하며, 운동 생성 프로세스를 자동화하고자 하는 피트니스 애호가, 운동선수, 그리고 Garmin 장치 사용자입니다.

주요 특징

• 광범위한 도구 세트: 활동 관리, 건강 및 웰빙, 훈련 성능, 영양을 아우르는 110개 이상의 도구를 구현합니다.
• 운동 빌더: 가공되지 않은 JSON 없이도 걷기/달리기 인터벌, Z2 걷기, 근력 운동을 생성할 수 있는 상위 수준의 도구를 제공합니다.
• uma l-click Install: Claude Desktop에 쉽게 설치할 수 있도록 .dxt 확장자 파일을 지원합니다.
• 고급 분석: 파워 존, FIT 파일 분석, 그리고 훈련 부하 트렌드(CTL/ATL/TSB)에 접근할 수 있습니다.
• 유연한 설정: LLM 컨텍스트 창 사용량을 줄이기 위해 특정 도구를 허용 목록(allowlist) 또는 차단 목록(denylist)에 추가할 수 있습니다.