Ctvidic Strava MCP Server

🚀 Strava MCP Server

A Model Context Protocol (MCP) server that provides access to the Strava API. This server allows language models to interact with Strava data, including activities, athlete information, etc.

🚀 Quick Start

The Strava MCP Server is a powerful tool that enables seamless interaction with the Strava API. It offers a range of features for activity tracking, athlete statistics, and more.

✨ Features

• 🏃♂️ Activity tracking and analysis
• 📊 Athlete statistics
• 🗺️ Route visualization
• 🏆 Achievement tracking
• 🤝 Social features (likes, comments)

📦 Installation

Prerequisites

• Python 3.12+
• Strava API credentials
• pip (Python package installer)

Steps

1. Clone the repository:

git clone https://github.com/yourusername/strava_mcp.git
cd strava_mcp

2. Create a virtual environment:

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

3. Install dependencies:

pip install -r requirements.txt

📚 Configuration

1. Create a config/.env file and add your Strava API credentials:

STRAVA_CLIENT_ID=your_client_id
STRAVA_CLIENT_SECRET=your_client_secret
STRAVA_REFRESH_TOKEN=your_refresh_token

2. How to obtain Strava API credentials:
   • Visit https://www.strava.com/settings/api
   • Create a new application
   • Record the client ID and client secret
   • Use OAuth 2.0 to obtain an access token

💻 Usage Examples

As an MCP Server

Basic Usage

# Initialize the Strava connection
from strava_mcp_server import connect_to_strava
connection = connect_to_strava("path/to/credentials.json")

Advanced Usage

# Send a query to Strava
response = connection.send_query("获取最近活动")
print(response)

As an HTTP Server

Basic Usage

# Start the server
python -m strava_mcp_server --port 5000

Advanced Usage

# Call the API endpoint
curl http://localhost:5000/api/recent_activities

🔧 Technical Details

Project Structure

• strava_mcp_server/: Contains the server implementation and related modules.
• config/: Stores configuration files, such as .env.

Contribution Guidelines

1. Fork the repository:

git clone https://github.com/yourusername/strava_mcp.git

2. Create a feature branch:

git checkout -b feature/new_functionality

3. Commit your changes:

git add .
git commit -m "添加新功能"
git push origin feature/new_functionality

4. Create a pull request.

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

👏 Acknowledgments

Thanks to the following resources and support:

• Strava API documentation
• Model Context Protocol (MCP) specification
• All contributors and maintainers

⚠️ Important Note

Avoid committing files containing sensitive information, such as .env and API credentials. They are already configured in .gitignore to prevent sensitive data from being committed to the version control system. Use environment variables to manage all sensitive configuration information.