TG

taxuspt/garmin_mcp

Developer tools

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기

1.4천 stars 449 forks 품질 87 트렌드 50MIT

가민 데이터에 접근하기 위한 MCP 서버

개요

이 모델 컨텍스트 프로토콜(MCP) 서버는 Garmin Connect에 연결되어 Claude 및 기타 MCP 호환 클라이언트에 귀하의 피트니스 및 건강 데이터를 노출합니다. 가민의 API는 훌륭한 python-garminconnect 라이브러리를 통해 접근할 수 있습니다. - 페이지네이션 지원 기능 제공 최근 활동 목록 - 상세 활동 정보 제공 - 활동 제목, 유형, 설명/노트, 이벤트 유형, 인지된 노력(RPE), 느낌 편집 - 건강 지표(걸음, 심박수, 수면, 스트레스, 호흡) 접근 - 체성분 데이터 보기 - 훈련 상태 및 준비 상태 추적 - 사이클링 FTP 및 젖산 임계값 지표 접근 - 장비 및 장비 관리 - 운동 및 훈련 계획 접근 - 반복 그룹 및 수영 페이스 목표 등 상세한 운동 단계 구조 점검 - 주간 건강 집계(걸수, 스트레스, 강도 분) - 고급 사이클링 분석: 파워 존, FIT 파일 분석, DI2 전자 변속 인텔리전스 - 훈련 부하 추세(CTL/ATL/TSB), HRV 추세, VO2 max 추세, 호흡률 추세 -...

개요(AI 번역)

이 모델 컨텍스트 프로토콜(MCP) 서버는 Garmin Connect에 연결되어 Claude 및 기타 MCP 호환 클라이언트에 귀하의 피트니스 및 건강 데이터를 노출합니다.

가민의 API는 훌륭한 python-garminconnect 라이브러리를 통해 접근할 수 있습니다.

특징

  • 페이지네이션 지원 관련 최근 활동 목록
  • 상세한 활동 정보 제공
  • 활동 편집: 이름, 유형, 설명/노트, 이벤트 유형, 인지된 노력(RPE), 느낌, 근력 운동 세트
  • 건강 지표(걸음, 심박수, 수면, 스트레스, 호흡) 접근
  • 신체 조성 데이터 보기
  • 훈련 상태 및 준비 태세 추적
  • 사이클링 FTP 및 락테이트 임계값 지표 접근
  • 장비와 장비 관리, [[T0]가 반환한 자유 텍스트 노트 포함)
  • 운동 및 훈련 계획 이용
  • 반복 그룹과 수영 페이스 목표를 포함한 상세한 운동 단계 구조를 점검합니다
  • 주간 건강 집계 (걸수, 스트레스, 강도 분)
  • 고급 사이클링 분석: 파워존, FIT 파일 분석, DI2 전자 변속 인텔리전스
  • 훈련 부하 추세(CTL/ATL/TSB), HRV 추세, VO2 max 추세, 호흡률 추세
  • 파워 듀레이션 곡선, VAM을 이용한 상승 감지, 심장 드리프트(유산소 분리), W/kg 계산

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요.

README

원문 README의 일부입니다. 원문 보기.

Garmin MCP Server

This Model Context Protocol (MCP) server connects to Garmin Connect and exposes your fitness and health data to Claude and other MCP-compatible clients.

Garmin’s API is accessed via the awesome python-garminconnect library.

Features

  • List recent activities with pagination support
  • Get detailed activity information
  • Edit activities: name, type, description/notes, event type, perceived effort (RPE), feel, and strength exercise sets
  • Access health metrics (steps, heart rate, sleep, stress, respiration)
  • View body composition data
  • Track training status and readiness
  • Access cycling FTP and lactate threshold metrics
  • Manage gear and equipment, including free-text notes returned by get_gear
  • Access workouts and training plans
  • Inspect detailed workout step structures, including repeat groups and swim pace targets
  • Weekly health aggregates (steps, stress, intensity minutes)
  • Advanced cycling analytics: power zones, FIT file analysis, DI2 electronic shift intelligence
  • Training load trend (CTL/ATL/TSB), HRV trend, VO2 max trend, respiration rate trend
  • Power Duration Curve, climb detection with VAM, cardiac drift (aerobic decoupling), W/kg calculations

Tool Coverage

This MCP server implements 110+ tools covering ~90% of the python-garminconnect library (v0.3.2):

  • ✅ Activity Management (21 tools) - includes write tools for type, description, event type, perceived effort, feel, and exercise sets
  • ✅ Health & Wellness (34 tools) - includes custom lightweight summary tools
  • ✅ Training & Performance (13 tools) - includes CTL/ATL/TSB, HRV, VO2 max, and respiration trends
  • ✅ Workouts (8 tools)
  • ✅ Devices (8 tools) - includes sending a workout to a device
  • ✅ Gear Management (5 tools)
  • ✅ Weight Tracking (5 tools)
  • ✅ Challenges & Badges (10 tools)
  • ✅ Nutrition (9 tools) - food logs, meals, custom foods, food logging, and multi-day intake summaries
  • ✅ Women’s Health (3 tools)
  • ✅ User Profile (3 tools)
  • ✅ High-Level Workout Builders (4 tools) - create and schedule workouts without writing JSON
  • ✅ Courses (5 tools) - list / get details / upload GPX as course / download GPX / delete course
  • ✅ Activity Analysis (2 tools) - FIT file parsing, Power Duration Curve; requires power meter and/or Di2
  • ✅ Activity File Downloads (2 tools) - download activity files in FIT, GPX, TCX, or CSV format

Note: Activity Analysis tools require a compatible power meter (e.g., Garmin Rally, Favero Assioma, PowerTap P1) and/or Shimano Di2 / SRAM eTap electronic shifting. The fitparse dependency is installed automatically.

Gear Notes

Each item in the gear array returned by get_gear includes a notes field

GitHub에서 전체 README 보기

설치

uvx --python 3.12 --from git+https://github.com/Taxuspt/garmin_mcp garmin-mcp
MCP 초보자라면? mcpskill.org 가이드부터 시작하세요 →

설정

{ "mcpServers": { "garmin": { "command": "uvx", "args": [ "--python", "3.12", "--from", "git+https://github.com/Taxuspt/garmin_mcp", "garmin-mcp" ] } } }