Taxuspt/garmin_mcp

해결하는 문제

이 프로젝트는 Garmin Connect와 AI 어시스턴트 사이의 가교 역할을 하여, Claude Desktop과 같은 LLM 인터페이스를 통해 직접 피트니스 데이터를 조회하고, 운동을 관리하며, 성과 지표를 분석할 수 있도록 합니다.

작동 방식

Model Context Protocol (MCP)을 구현하여 110개 이상의 Garmin Connect API 엔드포인트를 도구로 노출합니다. 안전한 CLI 흐름을 통해 한 번 인증하면 서버가 로컬에 OAuth 토큰을 저장하므로, 구성 파일에 자격 증명을 저장하지 않고도 LLM이 건강 및 활동 데이터에 안전하게 액세스할 수 있습니다. 데이터 읽기(심박수, 수면, 훈련 상태 등)와 쓰기(활동 세부 정보 편집 또는 운동 일정 예약 등)를 모두 지원합니다.

대상 사용자

AI를 활용하여 훈련에 대한 깊은 통찰력을 얻고, 복잡한 운동 일정을 자동으로 생성하거나, 자연어를 사용하여 활동 데이터에 대한 고급 분석을 수행하려는 Garmin 피트니스 기기 사용자에게 적합합니다.

주요 특징

• 광범위한 도구: 활동, 건강 지표, 훈련 상태, 장비 관리, 영양 등을 아우르는 110개 이상의 도구를 제공합니다.
• 고급 운동 빌더: JSON을 수동으로 작성할 필요 없이 복잡한 운동(인터벌 및 근력 운동 포함)을 생성하고 예약할 수 있습니다.
• 안전한 인증: 전용 CLI 도구를 사용하여 OAuth 토큰을 처리함으로써 민감한 자격 증명을 MCP 구성에서 분리합니다.
• 사용자 지정 가능한 액세스: 도구 필터링(허용 목록/차단 목록)을 지원하여 AI가 액세스할 수 있는 데이터나 작업을 제한할 수 있으며, 여러 Garmin 계정을 동시에 지원합니다.