가민 MCP 서버

이 MCP(Model Context Protocol) 서버는 Garmin Connect에 연결되어 사용자의 피트니스 및 건강 데이터를 Claude와 다른 MCP 호환 클라이언트에게 공개합니다.

특징

• 최근 활동 목록

• 자세한 활동 정보를 얻으세요

• 건강 지표(걸음 수, 심박수, 수면)에 액세스하세요

• 체성분 데이터 보기

Related MCP server: Intervals.icu MCP Server

설정

1. 새로운 환경에 필요한 패키지를 설치합니다.

지엑스피1

2. Garmin 자격 증명을 사용하여 프로젝트 루트에 .env 파일을 만듭니다.

GARMIN_EMAIL=your.email@example.com
GARMIN_PASSWORD=your-password

서버 실행

클로드 데스크톱과 함께

1. Claude Desktop에서 구성을 만듭니다.

Claude Desktop 구성 파일을 편집하세요.

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%\Claude\claude_desktop_config.json

다음 서버 구성을 추가합니다.

{
  "mcpServers": {
    "garmin": {
      "command": "python", // if you created a new environment this should be "<root_folder>/.venv/bin/python"
      "args": ["<path to>/garmin_mcp/garmin_mcp_server.py"]
    }
  }
}

경로를 서버 파일의 절대 경로로 바꾸세요.

2. Claude Desktop을 다시 시작하세요

MCP 검사관과 함께

테스트를 위해 MCP Inspector를 사용할 수 있습니다.

npx @modelcontextprotocol/inspector python /Users/adomingues/Documents/claude_filesystem/garmin_mcp/garmin_mcp_server.py

사용 예

Claude에 연결되면 다음과 같은 질문을 할 수 있습니다.

• "최근 활동 보기"

• "어젯밤에 잠을 어떻게 잤어요?"

• "어제 몇 걸음 걸었지?"

• "내 최근 달리기에 대한 세부 정보를 보여줘"

보안 참고 사항

이 서버를 사용하려면 .env 파일에 Garmin Connect 자격 증명이 필요합니다. 이 파일을 안전하게 보관하고 저장소에 커밋하지 마세요.

문제 해결

로그인 문제가 발생하는 경우:

1. .env 파일에서 자격 증명이 올바른지 확인하세요.

2. Garmin Connect에 추가 확인이 필요한지 확인하세요

3. GarminConnect 패키지가 최신 상태인지 확인하세요

다른 문제에 대해서는 다음 위치에서 Claude Desktop 로그를 확인하세요.

• macOS: ~/Library/Logs/Claude/mcp-server-garmin.log

• Windows: %APPDATA%\Claude\logs\mcp-server-garmin.log