Rbctmz MCP Server Strava

🚀 Integrating Strava API with Model Context Protocol (MCP) SDK

This project details how to integrate the Strava API with the Model Context Protocol (MCP) SDK. The following content includes features, requirements, installation guides, configuration steps, API and examples, as well as detailed development - related information.

🚀 Quick Start

This project focuses on integrating the Strava API with the Model Context Protocol (MCP) SDK. It enables users to analyze sports data, track performance, and receive personalized feedback.

✨ Features

• Sports Data Analysis: Analyze users' running, cycling, and other sports performance by fetching data from Strava.
• Performance Tracking: Integrate historical data to track long - term fitness progress.
• Personalized Feedback: Provide personalized training suggestions and feedback based on analysis results.

📦 Installation

Requirements

Installation Steps

Environment Configuration

pip install mcp-sdk stravalib

Quick Start

1. Register a Strava Application: Create a new application on the Strava Developer Console to obtain CLIENT_ID and CLIENT_SECRET.
2. Authorization: Use OAuth 2.0 to get an access token:

from stravalib import Client

client = Client()
auth_url = client.authorization_url(client_id=STRAVA_CLIENT_ID, redirect_uri='http://localhost:8000/auth/callback')
print(auth_url)

3. Data Retrieval: Fetch activity data from the Strava API:

from mcp_sdk import MCPClient

mcp = MCPClient()
activities = mcp.get_activities()

📚 Documentation

Configuration Guide

Environment Variable Setup

Add the following content to the .env file:

STRAVA_CLIENT_ID=your_client_id
STRAVA_CLIENT_SECRET=your_client_secret
STRAVA_REFRESH_TOKEN=your_refresh_token

Security Precautions

⚠️ Important Note

• Data Encryption: Encrypt sensitive data during transmission.
• Access Control: Use Role - Based Access Control (RBAC) to restrict API access.

API and Examples

Resource Overview

Usage Examples

Basic Usage

from stravalib import Client
from mcp_sdk import MCPClient

# Initialize the Strava client
strava_client = Client(access_token='your_access_token')

# Get activity data
activities = strava_client.get_activities()

# Analyze activity data and generate a report
mcp_client = MCPClient()
analysis_report = mcp_client.analyze_activities(activities)

🔧 Technical Details

Development Guide

CI/CD and Security Measures

• Code Inspection: Use Ruff for code formatting and quality control.
• Test Coverage: Ensure that the test coverage meets the requirements.

Test Commands

ruff format .
ruff check .
pytest --cov=src

Contribution Guide

1. Fork the Project Repository
2. Install Dependencies:

uv pip install -e ".[dev]"

3. Create a Feature Branch:

git checkout -b feature/name

4. Commit Changes and create a Pull Request.

Contact Information

• GitHub Issues: Create an Issue
• Telegram: @greg_kisel

📄 License

MIT