Strava MCP Server

🚀 Strava MCP 服務器

一個用於與 Strava API 交互的 Model Context Protocol (MCP) 服務器，藉助它可以便捷地實現與 Strava 數據的交互，為用戶提供豐富的活動數據查詢等功能。

🚀 快速開始

安裝

你可以通過 uvox 輕鬆安裝 Strava MCP：

uvox strava-mcp

設置 Strava 憑證

1. 創建 Strava API 應用：

   • 訪問 https://www.strava.com/settings/api
   • 創建一個新的應用以獲取你的客戶端 ID 和客戶端密鑰
   • 對於“授權回調域名”，輸入 localhost

2. 配置你的憑證： 創建一個憑證文件（例如，~/.ssh/strava.sh）：

   export STRAVA_CLIENT_ID=your_client_id
   export STRAVA_CLIENT_SECRET=your_client_secret
   

3. 配置 Claude Desktop： 將以下內容添加到 ~/.config/autocad/settings.json 文件中：

   {
       "stravaClientId": "你的客戶端 ID",
       "stravaClientSecret": "你的客戶端密鑰"
   }
   

認證流程

首次使用時，系統會自動啟動認證流程。瀏覽器將打開 Strava 的授權頁面。完成授權後，服務器將保存 refresh_token 以便後續使用。

✨ 主要特性

可用工具

• 獲取用戶活動：列出用戶的活動。
• 獲取單個活動：通過活動 ID 獲取詳細信息。
• 獲取活動段：通過活動 ID 獲取活動的各個階段。
• 獲取段排行榜：通過段 ID 獲取該段的排行榜。

參數說明

• include_all_efforts：是否包含所有努力（默認為 false）。
• per_page：每頁顯示的數量（默認為 50，最大為 100）。

📦 安裝指南

項目設置

1. 克隆倉庫：

   git clone https://github.com/yorrickjansen/strava-mcp.git
   cd strava-mcp
   

2. 安裝依賴：

   pip install -r requirements.txt
   

3. 配置環境變量：

   export STRAVA_CLIENT_ID=your_client_id
   export STRAVA_CLIENT_SECRET=your_client_secret
   

運行開發模式

uv serve --reload

手動認證

運行以下命令以手動獲取 refresh_token：

python -m strava_mcp.auth

💻 使用示例

基礎用法

# 安裝 Strava MCP
uvox strava-mcp

高級用法

# 克隆項目倉庫並安裝依賴
git clone https://github.com/yorrickjansen/strava-mcp.git
cd strava-mcp
pip install -r requirements.txt

# 配置環境變量
export STRAVA_CLIENT_ID=your_client_id
export STRAVA_CLIENT_SECRET=your_client_secret

# 運行開發模式
uv serve --reload

📚 詳細文檔

項目結構

• strava_mcp/init.py：初始化模塊。
• strava_mcp/auth.py：處理認證流程。
• strava_mcp/routes.py：定義 API 路由。

測試

使用 pytest 進行測試：

pytest tests/

發佈到 PyPI

構建包

uv build

發佈到 PyPI

uv publish

📄 許可證

MIT 許可證

致謝

• Strava API
• Model Context Protocol (MCP)