Strava MCP Server

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로 인증해야 합니다. 다음 단계를 따르세요.

  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 업데이트하여 다음을 포함하세요.

{ "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" } } } }

클로드 웹

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

예제 쿼리

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

  • "최근 내 활동은 무엇인가요?"
  • "지난주 활동을 보여주세요"
  • "지난 달에 제가 가장 길게 달린 것은 언제였나요?"
  • "내 최근 자전거 활동에 대한 세부 정보를 얻으세요"

오류 처리

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

  • 잘못된 날짜 형식
  • API 인증 오류
  • 네트워크 연결 문제

특허

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

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

언어 모델에 Strava API 데이터에 대한 액세스를 제공하여 언어 모델이 Strava에서 선수 활동을 쿼리하고 분석할 수 있도록 하는 모델 컨텍스트 프로토콜 서버입니다.

  1. Available Tools
    1. Activities Queries
  2. Activity Data Format
    1. Authentication
      1. Usage
        1. Claude for Desktop
        2. Claude Web
      2. Example Queries
        1. Error Handling
          1. License
            ID: kjgj5ovtdq