Strava MCP Server

🚀 Strava MCP 服務器

一個基於 Model Context Protocol (MCP) 的服務器，它提供了對 Strava API 的訪問能力，允許語言模型查詢已認證運動員的活動數據。

🚀 快速開始

本服務器可讓語言模型輕鬆查詢 Strava 中已認證運動員的活動數據。下面將詳細介紹使用前的準備工作。

✨ 主要特性

該服務器提供了一系列工具，用於查詢 Strava 中運動員的活動數據：

活動查詢

• get_activities(limit: int = 10)：獲取已認證運動員最近的活動。
• get_activities_by_date_range(start_date: str, end_date: str, limit: int = 30)：在特定日期範圍內獲取活動。日期需以 ISO 格式（YYYY-MM-DD）提供。
• get_activity_by_id(activity_id: int)：獲取某個特定活動的詳細信息。
• get_recent_activities(days: int = 7, limit: int = 10)：獲取過去 X 天內的活動。

📦 安裝指南

要使用此服務器，您需要通過 Strava API 進行身份驗證，具體步驟如下：

1. 創建 Strava API 應用：
   • 前往 Strava API 設置。
   • 創建一個應用以獲取您的 Client ID 和 Client Secret。
   • 將授權回調域設置為 localhost。
2. 獲取您的 refresh token：
   • 使用隨附的 get_strava_token.py 腳本：

python get_strava_token.py

- 按照提示輸入您的 Strava 憑證以獲取 refresh token。

3. 設置環境變量：
   • 將以下內容添加到 .env 文件或相應配置文件中：

STRAVA_REFRESH_TOKEN=your_refresh_token_here

📚 詳細文檔

活動數據格式

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

配置 MCP 服務器

根據您使用的語言模型（Claude Desktop 或 Web），按照以下步驟進行配置：

Claude Desktop

1. 打開 ~/.config/anthropic/claude/settings.json。
2. 在 "mcp" 下添加 Strava 插件：

"plugins": {
    "strava": {
        "enabled": true,
        "api_key": "your_api_key",
        "refresh_token": "your_refresh_token"
    }
}

3. 保存文件並重啟 Claude。

Claude Web

1. 訪問 Claude Web。
2. 進入設置頁面。
3. 在 MCP 部分添加 Strava 插件：
   • API 密鑰：your_api_key
   • Refresh Token：your_refresh_token

💻 使用示例

基礎用法

以下是一些示例查詢，幫助您快速上手：

查詢最近活動

print(strava.get_recent_activities())

獲取特定活動詳細信息

activity_id = 123456789
print(strava.get_activity_by_id(activity_id))

📄 許可證

本項目採用 MIT 許可證。

⚠️ 重要提示

• 確保您的 API 密鑰和 refresh token 安全，避免洩露。
• 定期更新 refresh token，以防止過期。
• 處理錯誤時，請參考文檔中的錯誤處理部分。

通過以上步驟，您可以輕鬆將 Strava 數據集成到語言模型中，擴展其功能。