Strava MCP 서버

Strava API에 대한 액세스를 제공하는 모델 컨텍스트 프로토콜 (MCP) 서버입니다. 언어 모델이 Strava API에서 선수 활동 데이터를 쿼리할 수 있도록 지원합니다.

사용 가능한 도구

서버는 다음 도구를 제공합니다.

활동 쿼리

• get_activities(limit: int = 10) : 인증된 운동선수의 최근 활동을 가져옵니다.

• get_activities_by_date_range(start_date: str, end_date: str, limit: int = 30) : 특정 날짜 범위 내의 활동을 가져옵니다.

• get_activity_by_id(activity_id: int) : 특정 활동에 대한 자세한 정보를 가져옵니다.

• get_recent_activities(days: int = 7, limit: int = 10) : 지난 X일 동안의 활동을 가져옵니다.

날짜는 ISO 형식( YYYY-MM-DD )으로 제공해야 합니다.

활동 데이터 형식

서버는 일관된 필드 이름과 단위를 사용하여 활동 데이터를 반환합니다.

입증

이 서버를 사용하려면 Strava API로 인증해야 합니다. 다음 단계를 따르세요.

1. Strava API 애플리케이션을 만드세요:

   • Strava API 설정 으로 이동

   • 클라이언트 ID와 클라이언트 비밀번호를 얻기 위한 애플리케이션을 만드세요

   • 권한 부여 콜백 도메인을 localhost 로 설정하세요

2. 새로 고침 토큰을 받으세요:

   • 포함된 get_strava_token.py 스크립트를 사용하세요: GXP1

   • 프롬프트에 따라 애플리케이션을 승인하세요.

   • 스크립트는 토큰을 .env 파일에 저장합니다.

3. 환경 변수 설정: 서버에는 다음과 같은 환경 변수가 필요합니다.

   • STRAVA_CLIENT_ID : Strava API 클라이언트 ID

   • STRAVA_CLIENT_SECRET : Strava API 클라이언트 비밀번호

   • STRAVA_REFRESH_TOKEN : Strava API 새로 고침 토큰

용법

데스크톱용 클로드

macOS에서는 ~/Library/Application\ Support/Claude/claude_desktop_config.json , Windows에서는 %APPDATA%/Claude/claude_desktop_config.json 에 있는 claude_desktop_config.json 업데이트하여 다음을 포함하세요.

클로드 웹

Claude Web의 경우 서버를 로컬로 실행하고 MCP 확장을 사용하여 연결할 수 있습니다.

예제 쿼리

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

• "최근 내 활동은 무엇인가요?"

• "지난주 활동을 보여주세요"

• "지난 달에 제가 가장 길게 달린 것은 언제였나요?"

• "내 최근 자전거 활동에 대한 세부 정보를 얻으세요"

오류 처리

서버는 일반적인 문제에 대해 사람이 읽을 수 있는 오류 메시지를 제공합니다.

• 잘못된 날짜 형식

• API 인증 오류

• 네트워크 연결 문제

특허

이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여되었습니다. 자세한 내용은 라이선스 파일을 참조하세요.