hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Integrations

Provides access to the Strava API for retrieving and analyzing activity data, including runs, rides, and workouts. Supports fetching activity details, athlete statistics, route visualization, achievement tracking, and social features like kudos and comments.

Strava MCP 서버

Strava API에 대한 액세스를 제공하는 모델 컨텍스트 프로토콜(MCP) 서버입니다. 이 서버를 통해 언어 모델이 활동, 선수 정보 등을 포함한 Strava 데이터와 상호 작용할 수 있습니다.

특징

🏃‍♂️ 활동 추적 및 분석
📊 선수 통계
🗺️ 경로 시각화
🏆 성과 추적
🤝 소셜 기능(쿠도스, 댓글)

필수 조건

파이썬 3.12+
Strava API 자격 증명
pip(Python 패키지 설치 프로그램)

설치

저장소를 복제합니다.

지엑스피1

가상 환경 만들기:

python -m venv venv
source venv/bin/activate  # On Windows: .\venv\Scripts\activate

종속성 설치:

pip install -r requirements.txt

구성

Strava API 자격 증명으로 config/.env 파일을 만듭니다.

STRAVA_CLIENT_ID=your_client_id
STRAVA_CLIENT_SECRET=your_client_secret
STRAVA_REFRESH_TOKEN=your_refresh_token

Strava API 자격 증명을 얻으려면:
- https://www.strava.com/settings/api 로 이동하세요
- 새로운 애플리케이션을 만듭니다
- 클라이언트 ID와 클라이언트 비밀번호를 기록해 두세요.
- OAuth 2.0 흐름을 따라 새로 고침 토큰을 받으세요.

용법

Claude와 함께 사용

연결되면 Claude를 통해 다양한 방법으로 Strava 데이터와 상호 작용할 수 있습니다.

활동 쿼리

"최근 활동 보기"
"마지막 달리기에 대한 세부 정보를 얻으세요"
"이번 달에 제가 가장 길게 탄 라이딩은 무엇이었나요?"
"내가 개인 기록을 세운 활동을 보여주세요"
"내 최근 활동에 대한 경로 지도를 표시합니다"

성과 분석

"올해 내 평균 달리기 속도는 얼마예요?"
"지난달과 이번달의 자전거 성능을 비교해 보세요"
"어제 운동에서 측정한 심박수 구간 보여줘"
"모든 활동을 통해 얻은 총 고도 상승은 얼마입니까?"
"주간 달리기 마일리지 계산해줘"

사회적 상호 작용

"내 최근 활동에 대해 칭찬해준 사람은 누구야?"
"내 마라톤 달리기에 대한 댓글 보여줘"
"내 모든 클럽 활동을 나열하세요"
"친구와 함께 했던 활동 찾기"

성과 추적

"내 모든 세그먼트 업적 나열"
"로컬 세그먼트에서 내 개인 기록을 보여주세요"
"이번 주에 어떤 성과를 거두었나요?"
"연간 목표에 대한 진행 상황을 보여주세요"

Claude를 통해 사용 가능한 데이터

활동 세부 정보:
- 거리, 지속 시간, 속도
- 경로 지도 및 고도 프로필
- 심박수, 파워 및 케이던스 데이터
- 스플릿 및 랩 정보
- 활동 중 날씨 상황
운동선수 통계:
- 연간 누적 및 역대 총계
- 개인 기록 및 성과
- 훈련 부하 및 피트니스 추세
- 장비 사용 및 유지 관리
소셜 데이터:
- 칭찬과 댓글
- 클럽 활동 및 리더보드
- 친구 활동 및 도전
- 세분화된 노력과 순위
경로 정보:
- 고도 데이터가 포함된 상세 지도
- 세그먼트 분석
- 인기 노선 및 구간
- 경로 계획 및 분석

MCP 서버로서

Claude Desktop 구성을 업데이트하세요.

{
    "mcpServers": {
        "Strava": {
            "command": "python",
            "args": ["src/strava_server.py"],
            "cwd": "/path/to/strava_mcp",
            "env": {
                "STRAVA_CLIENT_ID": "your_client_id",
                "STRAVA_CLIENT_SECRET": "your_client_secret",
                "STRAVA_REFRESH_TOKEN": "your_refresh_token"
            }
        }
    }
}

HTTP 서버로서

서버를 시작합니다:

./run_server.sh

http://localhost:8000 에서 API에 접속하세요

사용 가능한 엔드포인트:

GET /activities/recent - 최근 활동 나열
GET /activities/{id} - 활동 세부 정보 가져오기
GET /activities/{id}/map - 활동 맵 시각화 가져오기
GET /athlete/stats - 선수 통계 가져오기

개발

프로젝트 구조

strava_mcp/
├── src/
│   ├── strava_server.py      # MCP server implementation
│   ├── strava_http_server.py # HTTP API server
│   ├── map_utils.py          # Map visualization utilities
│   └── templates.py          # HTML templates
├── config/
│   └── .env                  # Environment variables (not in git)
├── requirements.txt          # Python dependencies
└── run_server.sh            # Server startup script

기여하다

저장소를 포크하세요
기능 브랜치 생성
변경 사항을 커밋하세요
지점으로 밀어 넣기
풀 리퀘스트 만들기

보안

.env 파일이나 API 자격 증명을 절대 커밋하지 마세요.
.gitignore 파일은 민감한 데이터가 커밋되는 것을 방지하도록 구성되어 있습니다.
모든 중요한 구성에 환경 변수를 사용하세요

특허

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

감사의 말

Strava API 문서
모델 컨텍스트 프로토콜(MCP) 사양
기여자 및 유지 관리자

This server cannot be installed

-

security - not tested

A

license - permissive license

-

quality - not tested

Strava 데이터(활동, 선수 통계, 경로, 성과, 소셜 기능 등)와 언어 모델이 상호 작용할 수 있도록 하는 모델 컨텍스트 프로토콜 서버입니다.

Related Resources

Reddit Discussion about this server

Strava MCP Server