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

Allows analysis of Strava workouts and provides training recommendations based on Strava data using the Model Context Protocol SDK

Strava API와 MCP(Model Context Protocol) SDK 통합

Model Context Protocol SDK를 사용하여 Strava 데이터를 기반으로 한 교육 분석 및 추천을 통합합니다.

🚀 특징

Strava에서 운동 분석
교육 권장 사항
자동 토큰 업데이트
API 요청에 대한 속도 제한

📋 요구 사항

파이썬 3.10+
클로드 데스크탑
Strava 계정
uv (추천)

⚙️ 설치

지엑스피1

MCP SDK 설치

uv add "mcp[cli]"

🔧 설정

Strava API 설정

API 설정 페이지 로 이동
애플리케이션을 생성하세요:
- 애플리케이션 이름: MCP Strava 통합
- 카테고리: 교육 분석
- 웹사이트: http://localhost
- 권한 부여 콜백 도메인: localhost

환경 설정

환경 변수가 있는 파일을 만듭니다.
cp .env-template .env
액세스 토큰을 받으세요:
python scripts/auth.py
설정을 확인하세요:
mcp dev src/server.py curl -X GET "http://localhost:8000/activities"

📚 API 및 예제

리소스 및 도구

유형	이름	설명
의지	`strava://activities`	활동 목록
의지	`strava://activities/{id}`	활동 세부 정보
의지	`strava://athlete/zones`	훈련 구역
의지	`strava://athlete/clubs`	운동선수 클럽
의지	`strava://gear/{gear_id}`	장비 정보
도구	`analyze_activity(activity_id)`	훈련 분석
도구	`analyze_training_load(activities)`	부하 분석
도구	`get_activity_recommendations()`	추천사항

사용 예

from mcp import ClientSession

# Получение активностей
async with ClientSession() as session:
    activities = await session.read_resource("strava://activities")
    activity = await session.read_resource("strava://activities/12345678")

# Анализ тренировки
result = analyze_activity(activity_id="12345678")
"""
{
    "type": "Run",
    "distance": 5000,
    "moving_time": 1800,
    "analysis": {
        "pace": 5.5,  # мин/км
        "effort": "Средняя"
    }
}
"""

# Анализ нагрузки
summary = analyze_training_load(activities)
"""
{
    "activities_count": 10,
    "total_distance": 50.5,  # км
    "total_time": 5.2,      # часы
    "heart_rate_zones": {
        "easy": 4,    # ЧСС < 120
        "medium": 4,  # ЧСС 120-150
        "hard": 2     # ЧСС > 150
    }
}
"""

# Получение тренировочных зон
async with ClientSession() as session:
    zones = await session.read_resource("strava://athlete/zones")
    """
    {
        "heart_rate": {
            "custom_zones": true,
            "zones": [
                {"min": 0, "max": 120, "name": "Z1 - Recovery"},
                {"min": 120, "max": 150, "name": "Z2 - Endurance"},
                {"min": 150, "max": 170, "name": "Z3 - Tempo"},
                {"min": 170, "max": 185, "name": "Z4 - Threshold"},
                {"min": 185, "max": -1, "name": "Z5 - Anaerobic"}
            ]
        },
        "power": {
            "zones": [
                {"min": 0, "max": 180},
                {"min": 181, "max": 250},
                {"min": 251, "max": 300},
                {"min": 301, "max": 350},
                {"min": 351, "max": -1}
            ]
        }
    }
    """

🛠 개발

CI/CD 및 보안

GitHub Actions의 체크

유형	도구	설명
린팅	주름 옷깃	코드 포맷팅 및 분석
테스트	파이테스트	단위 및 통합 테스트
코팅	pytest-cov	코드 커버리지 보고서

보안 및 비밀

토큰 보호:
- .env 에서 .gitignore 로
- CI/CD를 위한 GitHub의 비밀
- 속도 제한: 100개 요청/15분
비밀 설정:
# В GitHub: Settings → Secrets → Actions STRAVA_CLIENT_ID=<client_id> STRAVA_CLIENT_SECRET=<client_secret> STRAVA_REFRESH_TOKEN=<refresh_token>