remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
Integrations
Provides access to the Strava API, allowing queries for athlete activities including recent activities, activities by date range, specific activity details, and activities from a recent time period. Data returned includes activity metrics like distance, time, speed, elevation, and calories.
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
)으로 제공해야 합니다.
활동 데이터 형식
서버는 일관된 필드 이름과 단위를 사용하여 활동 데이터를 반환합니다.
필드 | 설명 | 단위 |
---|---|---|
name | 활동 이름 | - |
sport_type | 스포츠의 종류 | - |
start_date | 시작 날짜 및 시간 | ISO 8601 |
distance_metres | 거리 | 미터 |
elapsed_time_seconds | 총 경과 시간 | 초 |
moving_time_seconds | 이동 시간 | 초 |
average_speed_mps | 평균 속도 | 초당 미터 |
max_speed_mps | 최대 속도 | 초당 미터 |
total_elevation_gain_metres | 총 고도 상승 | 미터 |
elev_high_metres | 가장 높은 고도 | 미터 |
elev_low_metres | 가장 낮은 고도 | 미터 |
calories | 소모된 칼로리 | 킬로칼로리 |
start_latlng | 시작 좌표 | [위도, 경도] |
end_latlng | 종료 좌표 | [위도, 경도] |
입증
이 서버를 사용하려면 Strava API로 인증해야 합니다. 다음 단계를 따르세요.
- Strava API 애플리케이션을 만드세요:
- Strava API 설정 으로 이동
- 클라이언트 ID와 클라이언트 비밀번호를 얻기 위한 애플리케이션을 만드세요
- 권한 부여 콜백 도메인을
localhost
로 설정하세요
- 새로 고침 토큰을 받으세요:
- 포함된
get_strava_token.py
스크립트를 사용하세요: GXP1 - 프롬프트에 따라 애플리케이션을 승인하세요.
- 스크립트는 토큰을
.env
파일에 저장합니다.
- 포함된
- 환경 변수 설정: 서버에는 다음과 같은 환경 변수가 필요합니다.
STRAVA_CLIENT_ID
: Strava API 클라이언트 IDSTRAVA_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 라이선스에 따라 라이선스가 부여되었습니다. 자세한 내용은 라이선스 파일을 참조하세요.
You must be authenticated.
언어 모델에 Strava API 데이터에 대한 액세스를 제공하여 언어 모델이 Strava에서 선수 활동을 쿼리하고 분석할 수 있도록 하는 모델 컨텍스트 프로토콜 서버입니다.