Strava MCP 서버

파이썬 패키지 라이센스: MIT 파이썬 3.10

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 )으로 제공해야 합니다.

Related MCP server: Whoop MCP Server

활동 데이터 형식

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

필드	설명	단위
`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 클라이언트 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 업데이트하여 다음을 포함하세요.

{ "mcpServers": { "strava": { "command": "uvx", "args": [ "strava-mcp-server" ], "env": { "STRAVA_CLIENT_ID": "YOUR_CLIENT_ID", "STRAVA_CLIENT_SECRET": "YOUR_CLIENT_SECRET", "STRAVA_REFRESH_TOKEN": "YOUR_REFRESH_TOKEN" } } } }