Model Context Protocol (mcp) Server + Strava Oauth

🚀 模型上下文協議（MCP）服務器 + Strava OAuth

本項目是一個基於模型上下文協議 (MCP)的服務器，支持遠程 MCP 連接，還內置了 Strava 的 OAuth 登錄功能。用戶可連接到該 MCP 服務器，使用他們的 Strava 賬戶進行登錄。

🚀 快速開始

環境準備

在開始前，你需要準備以下條件：

• 擁有 Strava 賬戶
• 擁有 Cloudflare 賬戶
• 已安裝 Node.js 和 npm
• 已安裝 Wrangler CLI（可使用命令 npm install -g wrangler 進行安裝）

操作步驟

1. 克隆倉庫：

   git clone https://github.com/kw510/strava-mcp.git
   cd strava-mcp
   npm install
   

2. 設置 Strava API 憑證：具體設置方法請參考設置 Strava API 憑證。
3. 設置 Cloudflare KV 命名空間：

   wrangler kv:namespace create "OAUTH_KV"
   

   使用生成的 KV ID 更新 wrangler.toml 文件。
4. 部署到 Cloudflare：

   wrangler deploy
   

✨ 主要特性

OAuth 提供程序

• 藉助 workers-oauth 庫實現 OAuth 2.0 流程。
• 支持 Strava 的授權代碼流。
• 可配置回調 URL 和客戶端 ID/密鑰進行身份驗證。

持久化 MCP

• 在 Cloudflare KV 存儲中存儲連接狀態。
• 利用 durable-object 庫管理持久化會話和用戶數據。
• 實現安全的會話管理和狀態存儲。

MCP 代理

• 使用 @cloudflare/mcp-proxy 庫創建 MCP 代理。
• 支持通過 WebSocket 和 HTTP 的雙向通信。
• 提供對遠程模型的訪問，並處理請求和響應。

📦 安裝指南

設置 Strava API 憑證

生產環境

1. 前往Strava 的 API 設置並創建一個新的應用。
2. 配置您的應用程序：
   • 應用程序名稱：為您的應用程序選擇一個名稱
   • 類別：選擇適當的類別
   • 網站：您的網站 URL
   • 應用程序描述：簡要描述您的應用程序
   • 授權回調域名：mcp-strava-oauth.<your-subdomain>.workers.dev
   • 授權回調 URL：https://mcp-strava-oauth.<your-subdomain>.workers.dev/callback
3. 設置您的生產環境變量：

   wrangler secret put STRAVA_CLIENT_ID
   wrangler secret put STRAVA_CLIENT_SECRET
   

開發環境

1. 前往Strava 的開發者控制檯創建一個新的應用。
2. 配置您的應用程序：
   • 應用程序名稱：例如 MCP-Dev
   • 描述：簡短描述，如 MCP Development App
   • 網站 URL：http://localhost:3000
   • 授權回調 URL：http://localhost:3000/login/callback

💻 使用示例

測試您的 MCP 服務器

使用 Inspector

1. 安裝並啟動 Inspector。
2. 打開 Inspector 的控制檯。
3. 創建一個新的 MCP 連接：

   mcp create connection --name test-connection --url http://localhost:5000
   

4. 啟動連接：

   mcp start-connection test-connection
   

5. 在 Inspector 中，您應該看到來自 MCP 服務器的日誌和消息。

使用 Claude Desktop

1. 打開 Claude Desktop 並連接到您的 Cloudflare 賬戶。
2. 導航至 Compute 標籤並選擇您的 MCP 應用。
3. 在右側控制檯中，您可以與 MCP 代理交互：

   mcp create connection --name test-connection --url http://localhost:5000
   mcp start-connection test-connection
   

本地開發

1. 克隆倉庫並安裝依賴項。
2. 啟動開發服務器：

   npm run dev
   

3. 打開瀏覽器訪問 http://localhost:5000。

📚 詳細文檔

API 速率限制

• Strava 的免費 tier 每小時有 18,000 次調用的限制。
• 超出限制可能會導致請求被拒絕或延遲。

🔧 技術細節

OAuth 提供程序

• 使用 workers-oauth 庫實現 OAuth 2.0 流程。
• 支持 Strava 的授權代碼流。
• 配置回調 URL 和客戶端 ID/密鑰進行身份驗證。

持久化 MCP

• 在 Cloudflare KV 存儲中存儲連接狀態。
• 使用 durable-object 庫管理持久化會話和用戶數據。
• 實現安全的會話管理和狀態存儲。

MCP 代理

• 使用 @cloudflare/mcp-proxy 庫創建 MCP 代理。
• 支持通過 WebSocket 和 HTTP 的雙向通信。
• 提供對遠程模型的訪問，並處理請求和響應。

📄 注意事項

⚠️ 重要提示

• 確保所有回調 URL 配置正確且與 Strava 應用程序中的設置完全匹配。
• 定期檢查 API 調用限制，避免超出配額。
• 在生產環境中使用 HTTPS 並配置 SSL 證書以確保安全性。
• 使用環境變量管理敏感信息（如客戶端 ID 和密鑰）。

通過以上步驟，您可以成功部署並運行一個支持 Strava 登錄的 MCP 服務器，並利用 Cloudflare 的強大功能進行擴展和優化。