Ridewithgps MCP

🚀 RideWithGPS MCP 服務器

RideWithGPS MCP 服務器是您管理騎行冒險的 AI 助手，它基於 Model Context Protocol (MCP)，為您提供訪問 RideWithGPS API 的途徑，讓您可以輕鬆與路線、行程、活動和用戶數據進行交互。

🚀 快速開始

要求

• Node.js：版本 18.0.0 或更高，建議使用 20.0.0 及以上版本（點擊此處下載）

工具

此 MCP 服務器實現了以下工具：

路線檢索

• get_routes：獲取用戶在 RideWithGPS 上擁有的路線列表，按更新時間降序排列。

⚠️ 已知限制：此工具只能訪問您個人擁有的路線。與您共享但屬於他人的路線不會出現在結果中。 如果您想在此服務器上使用共享路線，請先將其複製到您自己的 RideWithGPS 賬戶中。

• get_route_details：獲取特定路線的完整詳細信息，包括軌跡點、路線點和興趣點。您可以在此處查看可用的信息列表。

行程與活動數據

• get_trips：獲取用戶在 RideWithGPS 上擁有的行程/活動列表，按更新時間降序排列。
• get_trip_details：獲取特定行程的完整詳細信息，包括軌跡點和性能數據。您可以在此處查看可用的信息列表。

用戶資料

• get_current_user：獲取用戶的個人資料信息。

活動參與

• get_events：獲取用戶擁有的活動的分頁列表，按創建時間降序排列。
• get_event_details：獲取特定活動的完整詳細信息，包括相關路線。

數據同步

• sync_user_data：獲取用戶自指定日期時間以來與之交互過的項目（路線和/或行程）。

安裝

在命令行中，克隆此倉庫並進入其目錄

git clone https://github.com/boezzz/ridewithgps-mcp.git
cd ridewithgps-mcp

構建服務器應用程序

npm install
npm run build

配置 Claude 桌面應用 您可以安裝支持 MCP 的 Claude 桌面應用，其他常見的 MCP 客戶端也應該可以使用。

您可以從以下位置獲取 RideWithGPS API 憑證：

1. API 密鑰：訪問您的 RideWithGPS 賬戶中的開發者設置頁面，並創建一個 API 客戶端。
2. 身份驗證令牌：選擇您創建的 API 客戶端並進入其編輯頁面，點擊“創建新的身份驗證令牌”以獲取新的身份驗證令牌。

然後，打開您的 Claude 桌面應用設置，轉到“開發者”，並選擇“編輯配置”。或者，在您的 claude_desktop_config.json 文件中添加一個新的 MCP 服務器：

{
  "mcpServers": {
    "ridewithgps-mcp": {
      "command": "node",
      "args": ["/absolute/path/to/ridewithgps-mcp/build/index.js"],
      "env": {
        "RWGPS_API_KEY": "your_api_key_here",
        "RWGPS_AUTH_TOKEN": "your_auth_token_here"
      }
    }
  }
}

現在，您可以啟動 Claude 桌面應用，並讓它與您的 RideWithGPS 數據進行交互。

示例查詢

• “顯示我最近的路線”
• “獲取我昨天創建的世紀路線的詳細信息”
• “列出我上個月的騎行行程”
• “我即將參加哪些活動，我可能會臨陣退縮？”
• “顯示我的用戶資料，這樣我就可以欣賞我樂觀設定的低體重了”
• “同步我自上週以來的數據，當時我假裝去咖啡店的步行是一次訓練騎行”

要在其他本地 MCP 客戶端上使用 RideWithGPS MCP 服務器，請遵循相同的步驟。

📚 詳細文檔

API 覆蓋範圍

此 MCP 服務器實現了 RideWithGPS API 中針對個人用戶的主要端點，不包括特定於組織的功能。

完整的 API 文檔請參閱：https://github.com/ridewithgps/developers

開發

歡迎貢獻代碼！要為這個項目做出貢獻，請按以下步驟操作：

1. 將此倉庫 fork 到您自己的 GitHub 賬戶。
2. 在本地克隆您的 fork。
3. 安裝依賴項：npm install
4. 在 src/ 目錄下的 TypeScript 源文件中進行更改。
5. 構建項目：npm run build
6. 使用 npm run inspector 測試您的更改。
7. 提交併將您的更改推送到您的 fork。
8. 向主倉庫提交拉取請求以進行審核。

開發路線圖

• 使用 OAuth 進行安全的用戶身份驗證。
• 將 MCP 服務器部署到 Smithery/Glama 進行分發。
• 整合地理空間感知的軌跡點；目前僅顯示數量。
• 使分頁可選；按出發時間降序而不是更新時間返回行程也會很有幫助。

📄 許可證

本項目採用 MIT 許可證 - 詳情請參閱 LICENSE 文件。