Ctvidic Strava MCP Server

🚀 Strava MCP 服務器

Strava MCP 服務器是一個基於 Model Context Protocol (MCP) 的服務器，它提供了對 Strava API 的訪問能力。藉助該服務器，語言模型能夠與 Strava 數據進行交互，涵蓋活動、運動員信息等多個方面。

🚀 快速開始

Strava MCP 服務器允許語言模型與 Strava 數據交互。以下是快速開始使用該服務器的步驟：

安裝

git clone https://github.com/yourusername/strava_mcp.git
cd strava_mcp
python -m venv venv
source venv/bin/activate  # 在 Windows 中：.\venv\Scripts\activate
pip install -r requirements.txt

配置

創建 config/.env 文件並添加您的 Strava API 憑證：

STRAVA_CLIENT_ID=your_client_id
STRAVA_CLIENT_SECRET=your_client_secret
STRAVA_REFRESH_TOKEN=your_refresh_token

獲取 Strava API 憑證，您可以訪問 Strava API 設置頁面，創建一個新的應用，記錄下客戶端 ID 和客戶端密鑰，並使用 OAuth 2.0 獲取訪問令牌。

使用

作為 MCP 服務器

from strava_mcp_server import connect_to_strava
connection = connect_to_strava("path/to/credentials.json")
response = connection.send_query("獲取最近活動")
print(response)

作為 HTTP 服務器

python -m strava_mcp_server --port 5000
curl http://localhost:5000/api/recent_activities

✨ 主要特性

• 🏃♂️ 活動跟蹤與分析：對 Strava 中的活動數據進行跟蹤和深入分析。
• 📊 運動員統計數據：提供運動員的各項統計信息。
• 🗺️ 路線可視化：實現路線的可視化展示。
• 🏆 成就追蹤：追蹤運動員所取得的成就。
• 🤝 社交功能（點贊、評論）：支持社交互動，如點贊和評論。

📦 安裝指南

先決條件

• Python 3.12+
• Strava API 憑證
• pip（Python 包安裝工具）

安裝步驟

1. 克隆倉庫：

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

2. 創建虛擬環境：

python -m venv venv
source venv/bin/activate  # 在 Windows 中：.\venv\Scripts\activate

3. 安裝依賴項：

pip install -r requirements.txt

💻 使用示例

作為 MCP 服務器

基礎用法

from strava_mcp_server import connect_to_strava
connection = connect_to_strava("path/to/credentials.json")

高級用法

response = connection.send_query("獲取最近活動")
print(response)

作為 HTTP 服務器

基礎用法

python -m strava_mcp_server --port 5000

高級用法

curl http://localhost:5000/api/recent_activities

📚 詳細文檔

配置

創建 config/.env 文件並添加您的 Strava API 憑證：

STRAVA_CLIENT_ID=your_client_id
STRAVA_CLIENT_SECRET=your_client_secret
STRAVA_REFRESH_TOKEN=your_refresh_token

獲取 Strava API 憑證的方法：

• 訪問 Strava API 設置頁面
• 創建一個新的應用
• 記錄下客戶端 ID 和客戶端密鑰
• 使用 OAuth 2.0 獲取訪問令牌

開發部分

項目結構

• strava_mcp_server/: 包含服務器實現和相關模塊。
• config/: 存放配置文件，如 .env。

貢獻指南

1. 叉取倉庫：

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

2. 創建功能分支：

git checkout -b feature/new_functionality

3. 提交更改：

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

4. 創建拉取請求。

🔧 技術細節

安全注意事項

• 避免提交包含敏感信息的文件，如 .env 和 API 憑證。
• 已在 .gitignore 中配置，防止敏感數據被提交到版本控制系統中。
• 使用環境變量管理所有敏感配置信息。

📄 許可證

此項目採用 MIT 許可證 - 有關詳細信息，請參閱 LICENSE 文件。

致謝

感謝以下資源和支持：

• Strava API 文檔
• Model Context Protocol (MCP) 規範
• 所有貢獻者和維護人員