MCP Uber

🚀 MCP Uber Server

AIアシスタントを通じてUberの乗車予約を行うためのMCP（Model Context Protocol）サーバーです。

✨ 主な機能

• UberとのOAuth 2.0認証
• 乗車の料金見積もりを取得
• Uberの乗車をリクエスト
• 乗車のステータスを確認
• 乗車をキャンセル

📦 インストール

npmを使用する場合（グローバルインストール）

npm install -g mcp-uber

npxを使用する場合（インストール不要）

npx mcp-uber

📚 ドキュメント

ステップ1: Uber開発者アカウントを作成する

1. Uber Developer Dashboardにアクセスします。
2. 「サインイン」をクリックし、以下のいずれかを行います。
   • 既存のUberライダー/ドライバーアカウントを使用する。
   • 開発用に新しいアカウントを作成する。

💡 使用建议

組織の場合は、個人アカウントを使用する代わりに、メールエイリアス（例：dev@yourcompany.com）を作成すると、所有権の移管が容易になります。

ステップ2: 新しいアプリを作成する

1. Developer Dashboardで、右上隅の「Create App」をクリックします。
2. 必要な情報を入力します。
   • App Name：アプリケーションの名前
   • Description：アプリが行うことの簡単な説明
3. 「Create」をクリックします。

ステップ3: API資格情報を取得する

1. ダッシュボードで自分のアプリに移動します。
2. Authタブに移動します。
3. 以下が表示されます。
   • Client ID：アプリの公開識別子
   • Client Secret：秘密鍵（これは安全に保管してください！）
   • Server Token：サーバー側のリクエスト用

ステップ4: OAuth設定を構成する

1. Authタブで、リダイレクトURIを追加します。
   • ローカルテスト用：http://localhost:3000/callback
   • 本番環境用：実際のコールバックURL
2. 必要なスコープを選択します。
   • profile - ユーザーの基本的なプロファイル情報
   • request - ユーザーの代わりに乗車をリクエストする
   • ride_request - アクティブな乗車リクエストを表示および管理する

⚠️ 重要提示

requestスコープは特権付きで、本番環境で使用する場合はUberの承認が必要です。開発中は、承認なしでアカウントを使用できます。

ステップ5: 環境変数を設定する

資格情報を使用して環境変数を作成します（以下の構成セクションを参照）。

💻 使用例

Claude Desktopでの使用

npmを使用する場合（グローバルインストール）

Claude Desktopの設定（~/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 Desktopの設定に追加します。

{
  "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 - Uberの乗車をリクエストする
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を訪問し、アプリを承認します。
   • 承認後、Uberはコード付きでコールバックURLにリダイレクトします。
   • コードをアクセストークンに交換します（独自のコールバックハンドラーを設定する必要があります）。
   • uber_set_access_tokenを使用してトークンをMCPサーバーに保存します。

3. コールバックハンドラーを設定します。

   • テスト用には、簡単なExpressサーバーを使用できます（GitHubリポジトリのexamples/oauth-server.jsを参照）。
   • 本番環境では、アプリケーションに安全なコールバックハンドラーを実装します。
   • コールバックURLは、Uberアプリで構成されているものと正確に一致する必要があります。

重要な注意事項

サンドボックスと本番環境の比較

• サンドボックスモード（デフォルト）：

  • シミュレートされた乗車とドライバー
  • 実際の料金は発生しません
  • テストに最適
  • 開発者アカウントに限定されます

• 本番環境モード：

  • 実際の乗車と料金
  • 特権付きスコープにはUberの承認が必要
  • Uberのレビュープロセスを通過する必要があります

セキュリティのベストプラクティス

1. 資格情報をコミットしないでください：クライアントシークレットを安全に保管してください。
2. 環境変数を使用してください：資格情報をハードコードしないでください。
3. 適切なトークン保存を実装してください：現在のメモリ内保存はデモ用です。
4. リダイレクトURIを検証してください：コールバックURLがUberアプリで正しく構成されていることを確認してください。

APIの制限事項

• レート制限が適用されます（Uberのドキュメントを確認してください）。
• 特権付きスコープは、本番環境での使用には承認が必要です。
• サンドボックスモードは、本番環境と比較していくつかの制限があります。

トラブルシューティング

• 「Invalid scope」エラー：本番環境で特権付きスコープを使用するには、アプリの承認が必要です。
• 「Invalid redirect URI」：リダイレクトURIがUberダッシュボードで構成されているものと正確に一致することを確認してください。
• 「Unauthorized」エラー：アクセストークンが有効で期限切れでないことを確認してください。

リソース

• Uber API Documentation
• OAuth 2.0 Guide
• Sandbox Testing Guide
• API Status Page