MCP Uber

🚀 MCP優步服務器

這是一個MCP（模型上下文協議）服務器，可通過AI助手預訂優步（Uber）出行服務。它提供了與優步API的集成，讓你可以方便地獲取價格估算、請求行程、查看行程狀態等。

✨ 主要特性

• 支持與優步進行OAuth 2.0認證。
• 獲取行程價格估算。
• 請求優步出行服務。
• 檢查行程狀態。
• 取消行程。

📦 安裝指南

使用npm（全局安裝）

npm install -g mcp-uber

使用npx（無需安裝）

npx mcp-uber

🚀 快速開始

步驟1：創建優步開發者賬戶

1. 訪問 優步開發者控制檯。
2. 點擊“登錄”，你可以選擇：
   • 使用現有的優步乘客/司機賬戶。
   • 創建一個專門用於開發的新賬戶。

💡 使用建議

對於企業用戶，建議創建一個電子郵件別名（例如，dev@yourcompany.com），而不是使用個人賬戶，這樣便於所有權轉移。

步驟2：創建新應用

1. 在 開發者控制檯 中，點擊右上角的“創建應用”。
2. 填寫所需信息：
   • 應用名稱：你的應用程序名稱。
   • 描述：簡要描述你的應用程序的功能。
3. 點擊“創建”。

步驟3：獲取API憑證

1. 在控制檯中導航到你的應用。
2. 轉到“認證”選項卡。
3. 你將找到以下信息：
   • 客戶端ID：你的應用的公共標識符。
   • 客戶端密鑰：私有密鑰（請妥善保管！）。
   • 服務器令牌：用於服務器端請求。

步驟4：配置OAuth設置

1. 在“認證”選項卡中，添加你的重定向URI：
   • 本地測試：http://localhost:3000/callback。
   • 生產環境：你的實際回調URL。
2. 選擇所需的權限範圍：
   • profile - 用戶的基本個人資料信息。
   • request - 代表用戶請求行程。
   • ride_request - 查看和管理活躍的行程請求。

⚠️ 重要提示

request 權限範圍是特權範圍，生產環境使用需要優步的批准。在開發過程中，你的賬戶可以無需批准使用該範圍。

步驟5：設置環境變量

創建包含你的憑證的環境變量（請參閱下面的配置部分）。

💻 使用示例

與Claude桌面應用配合使用

使用npm（全局安裝）

將以下內容添加到你的Claude桌面應用配置文件（~/Library/Application Support/Claude/claude_desktop_config.json）中：

{
  "mcpServers": {
    "uber": {
      "command": "mcp-uber",
      "env": {
        "UBER_CLIENT_ID": "your_client_id",
        "UBER_CLIENT_SECRET": "your_client_secret",
        "UBER_REDIRECT_URI": "http://localhost:3000/callback",
        "UBER_ENVIRONMENT": "sandbox"
      }
    }
  }
}

使用npx

將以下內容添加到你的Claude桌面應用配置文件中：

{
  "mcpServers": {
    "uber": {
      "command": "npx",
      "args": ["mcp-uber"],
      "env": {
        "UBER_CLIENT_ID": "your_client_id",
        "UBER_CLIENT_SECRET": "your_client_secret",
        "UBER_REDIRECT_URI": "http://localhost:3000/callback",
        "UBER_ENVIRONMENT": "sandbox"
      }
    }
  }
}

可用工具

1. uber_get_auth_url - 獲取OAuth授權URL。
2. uber_set_access_token - 設置用戶的訪問令牌。
3. uber_get_price_estimates - 獲取行程的價格估算。
4. uber_request_ride - 請求優步出行服務。
5. uber_get_ride_status - 檢查行程請求狀態。
6. uber_cancel_ride - 取消行程請求。

OAuth流程

1. 使用 uber_get_auth_url 獲取授權URL。
2. 用戶訪問該URL並授權你的應用。
3. 回調後，將授權碼兌換為訪問令牌。
4. 使用 uber_set_access_token 存儲令牌。
5. 現在你可以進行API調用。

📚 詳細文檔

配置

環境變量

MCP服務器需要以下環境變量：

測試集成

1. 使用沙盒模式進行測試：

   • 在你的環境中設置 UBER_ENVIRONMENT=sandbox。
   • 沙盒模式模擬行程請求，無需真實司機。
   • 非常適合開發和測試。

2. 測試OAuth流程：

   • 使用 uber_get_auth_url 工具獲取授權URL。
   • 訪問該URL並授權你的應用。
   • 授權後，優步將使用授權碼重定向到你的回調URL。
   • 將授權碼兌換為訪問令牌（你需要設置自己的回調處理程序）。
   • 使用 uber_set_access_token 將令牌存儲在MCP服務器中。

3. 設置回調處理程序：

   • 測試時，你可以使用一個簡單的Express服務器（請參閱 GitHub倉庫 中的 examples/oauth-server.js）。
   • 生產環境中，在你的應用程序中實現一個安全的回調處理程序。
   • 回調URL必須與你在優步應用中配置的完全匹配。

重要注意事項

沙盒模式與生產環境

• 沙盒模式（默認）：

  • 模擬行程和司機。
  • 無實際費用。
  • 非常適合測試。
  • 僅限於你的開發者賬戶。

• 生產環境：

  • 真實行程和費用。
  • 特權範圍需要優步批准。
  • 必須通過優步的審核流程。

安全最佳實踐

1. 切勿提交憑證：妥善保管你的客戶端密鑰。
2. 使用環境變量：不要硬編碼憑證。
3. 實施適當的令牌存儲：當前的內存存儲僅用於演示。
4. 驗證重定向URI：確保你的回調URL配置正確。

API限制

• 存在速率限制（請查看優步的文檔）。
• 特權範圍在生產環境使用需要批准。
• 沙盒模式與生產環境相比有一些限制。

故障排除

• “無效範圍”錯誤：你的應用在生產環境中使用特權範圍需要批准。
• “無效重定向URI”：確保你的重定向URI與優步控制檯中配置的完全匹配。
• “未授權”錯誤：檢查你的訪問令牌是否有效且未過期。

資源

• 優步API文檔
• OAuth 2.0指南
• 沙盒測試指南
• API狀態頁面