Tomekkorbak Strava MCP Server

🚀 Strava MCP 服務器

一個提供對 模型上下文協議 (MCP) 的訪問的 Strava API 服務器。它允許語言模型查詢運動員的活動數據，為語言模型與運動員活動數據的交互搭建了橋樑。

🚀 快速開始

要使用此服務器，您需要通過 Strava API 進行身份驗證。按照以下步驟操作：

1. 創建 Strava API 應用：
   • 前往 Strava API 設置
   • 登錄後創建新應用
   • 記錄生成的 Client ID 和 Client Secret
2. 獲取刷新令牌：
   • 使用 Strava 應用的憑證，通過 OAuth 或其他方式獲取刷新令牌
   • 刷新令牌用於後續訪問運動員數據
3. 設置環境變量：
   • 將 STRAVA_CLIENT_ID 和 STRAVA_CLIENT_SECRET 添加到您的環境中

在 Claude Desktop 上使用：

• 打開終端並運行以下命令：

python3 src/main.py --config config.yaml

在 Claude Web 上使用：

• 將項目文件夾中的內容上傳到服務器
• 配置 Web 應用以訪問 Strava API

✨ 主要特性

• 工具豐富：服務器公開了多種活動查詢工具，方便獲取運動員的活動數據。
• 數據格式一致：返回具有一致字段名稱和單位的活動數據，便於處理和分析。
• 錯誤處理友好：提供常見錯誤的友好提示信息，如網絡問題、認證失敗或無效輸入。

📦 安裝指南

暫未提及具體安裝命令，此部分跳過。

💻 使用示例

基礎用法

該服務器公開了以下工具：

活動查詢

• get_activities(limit: int = 10)：獲取已認證運動員最近的活動
• get_activities_by_date_range(start_date: str, end_date: str, limit: int = 30)：在特定日期範圍內獲取活動
• get_activity_by_id(activity_id: int)：獲取特定活動的詳細信息
• get_recent_activities(days: int = 7, limit: int = 10)：獲取過去 X 天內的活動

日期應以 ISO 格式（YYYY-MM-DD）提供。

📚 詳細文檔

活動數據格式

服務器返回具有一致字段名稱和單位的活動數據：

🔧 技術細節

暫未提供具體的技術實現細節，此部分跳過。

📄 許可證

MIT 許可證