MCP Server Strava

🚀 將Strava API與模型上下文協議（MCP）SDK集成的完整指南

本指南詳細介紹瞭如何將Strava API與Model Context Protocol (MCP) SDK集成。通過此集成，您可以訪問和分析來自Strava平臺的運動數據，並利用MCP的強大功能進行進一步處理。

🚀 快速開始

本項目聚焦於將Strava API與Model Context Protocol (MCP) SDK集成，藉助此集成，您能夠訪問並分析Strava平臺的運動數據，同時利用MCP的強大功能開展進一步處理。

✨ 主要特性

• 數據獲取：從Strava獲取詳細的運動數據分析。
• 資源管理：管理並配置運動數據中的各種資源。
• 性能分析：使用MCP SDK對運動表現進行深入分析。

📦 安裝指南

安裝要求

1. Python版本：需要Python 3.8或更高版本。
2. 依賴項：
   • mcp-sdk：MCP SDK的最新穩定版本。
   • strava-api-python：Strava API的官方Python庫。
   • requests：處理HTTP請求的基本庫。

安裝步驟

1. 安裝MCP SDK：

   pip install mcp-sdk
   

2. 安裝Strava API庫：

   pip install strava-api-python
   

📚 詳細文檔

配置步驟

1. 註冊應用：在Strava開發者控制檯創建新的應用程序，並獲取客戶端ID和秘密。
2. 設置環境變量：

   export STRAVA_CLIENT_ID=your_client_id
   export STRAVA_CLIENT_SECRET=your_client_secret
   

API資源與工具示例

資源概覽

工具示例

from strava import StravaApi
from mcp_sdk import MCPClient

# 初始化Strava API客戶端
strava = StravaApi(client_id=STRAVA_CLIENT_ID, client_secret=STRAVA_CLIENT_SECRET)

# 獲取活動數據
activities = strava.get_activities()

# 使用MCP SDK進行分析
mcp = MCPClient()
analysis_results = mcp.analyze(activities)

開發信息

CI/CD與安全性

• 代碼覆蓋率：72%
• 測試通過率：15/20
• 代碼風格：使用Ruff進行格式化和檢查。

GitHub Actions檢查

安全措施

1. 令牌保護：
   • 將.env文件添加到.gitignore。
   • 使用GitHub Secrets管理CI/CD密鑰。
2. 速率限制：每15分鐘限制為100個請求。

貢獻指南

1. Fork倉庫
2. 安裝依賴：

   uv pip install -e ".[dev]"
   

3. 創建功能分支：

   git checkout -b feature/name
   

4. 驗證更改：

   ruff format .
   ruff check .
   pytest --cov=src
   

支持與聯繫

• GitHub問題：創建新問題
• Telegram：@greg_kisel

📄 許可證

MIT