MCP Server Strava

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

This guide details how to integrate the Strava API with the Model Context Protocol (MCP) SDK. Through this integration, you can access and analyze sports data from the Strava platform and leverage the powerful features of MCP for further processing.

✨ Features

• Data Retrieval: Obtain detailed sports data analysis from Strava.
• Resource Management: Manage and configure various resources in sports data.
• Performance Analysis: Conduct in - depth analysis of sports performance using the MCP SDK.

📦 Installation Requirements

1. Python Version: Python 3.8 or higher is required.
2. Dependencies:
   • mcp-sdk: The latest stable version of the MCP SDK.
   • strava-api-python: The official Python library for the Strava API.
   • requests: A basic library for handling HTTP requests.

📦 Installation Guide

1. Install the MCP SDK:

   pip install mcp-sdk
   

2. Install the Strava API Library:

   pip install strava-api-python
   

Configuration Steps

1. Register an Application: Create a new application in the Strava Developer Console and obtain the client ID and secret.
2. Set Environment Variables:

   export STRAVA_CLIENT_ID=your_client_id
   export STRAVA_CLIENT_SECRET=your_client_secret
   

💻 Usage Examples

API Resources Overview

Tool Example

from strava import StravaApi
from mcp_sdk import MCPClient

# Initialize the Strava API client
strava = StravaApi(client_id=STRAVA_CLIENT_ID, client_secret=STRAVA_CLIENT_SECRET)

# Get activity data
activities = strava.get_activities()

# Use the MCP SDK for analysis
mcp = MCPClient()
analysis_results = mcp.analyze(activities)

🔧 Technical Details

CI/CD and Security

• Code Coverage: 72%
• Test Pass Rate: 15/20
• Code Style: Use Ruff for formatting and checking.

GitHub Actions Checks

Security Measures

1. Token Protection:
   • Add the .env file to .gitignore.
   • Use GitHub Secrets to manage CI/CD keys.
2. Rate Limiting: Limit to 100 requests every 15 minutes.

Contribution Guidelines

1. Fork the Repository
2. Install Dependencies:

   uv pip install -e ".[dev]"
   

3. Create a Feature Branch:

   git checkout -b feature/name
   

4. Verify Changes:

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

Support and Contact

• GitHub Issues: Create a new issue
• Telegram: @greg_kisel

📄 License

MIT