Uber MCP Server

AI asistanları için kapsamlı Uber entegrasyonu sağlayan Model Context Protocol (MCP) sunucusu. Bu server, AI asistanlarının Uber API'si ile etkileşime girmesini ve yolculuk yönetimi yapmasını sağlar.

🚗 Özellikler

Temel İşlevler

Araç Çağırma: uberX, uberXL, Comfort, Black ve diğer araç türlerini çağırma
Fiyat Tahmini: Yolculuk öncesi fiyat tahmini alma
Süre Tahmini: Sürücünün gelme süresini tahmin etme
Yolculuk Takibi: Aktif yolculukların durumunu takip etme
İptal İşlemi: Yolculukları iptal etme
Yolculuk Geçmişi: Geçmiş yolculukları görüntüleme
Şoför Puanlama: Tamamlanan yolculuklar için şoför değerlendirme

Teknik Özellikler

TypeScript: Tip güvenliği ve modern JavaScript desteği
Zod Validasyonu: Güçlü veri doğrulama
Hata Yönetimi: Kapsamlı hata yakalama ve raporlama
OAuth 2.0: Güvenli kimlik doğrulama
Türkçe Dil Desteği: Tam Türkçe arayüz ve mesajlar
Sandbox Desteği: Geliştirme için test ortamı

📋 Gereksinimler

Node.js 18.0.0 veya üzeri
TypeScript 5.0+
Uber Developer hesabı ve API anahtarları
@modelcontextprotocol/sdk

🔧 Kurulum

1. Bağımlılıkları Yükleyin

cd /root/.openclaw/workspace/mcp-servers/uber-mcp/
npm install

2. Çevre Değişkenlerini Ayarlayın

.env.example dosyasını .env olarak kopyalayın ve gerekli bilgileri doldurun:

cp .env.example .env

.env dosyasını düzenleyin:

# Uber API Yapılandırması
UBER_CLIENT_ID=uber_client_id_buraya
UBER_CLIENT_SECRET=uber_client_secret_buraya
UBER_SERVER_TOKEN=uber_server_token_buraya
UBER_SANDBOX=true

# OAuth Yapılandırması
UBER_REDIRECT_URI=http://localhost:3000/auth/callback
UBER_SCOPE=profile request history

# API Yapılandırması
UBER_API_BASE_URL=https://api.uber.com
UBER_SANDBOX_API_BASE_URL=https://sandbox-api.uber.com

# MCP Server Yapılandırması
MCP_SERVER_NAME=uber-mcp-server
MCP_SERVER_VERSION=1.0.0

# Loglama
LOG_LEVEL=info

# Dil Desteği
DEFAULT_LANGUAGE=tr
SUPPORTED_LANGUAGES=en,tr

3. Uber Developer Hesabı Kurulumu

Uber Developer Portal'a gidin
Yeni bir uygulama oluşturun
Client ID, Client Secret ve Server Token'ı alın
Redirect URI'yi ayarlayın: http://localhost:3000/auth/callback
Gerekli scope'ları etkinleştirin: profile, request, history

4. Projeyi Derleyin

npm run build

5. Sunucuyu Başlatın

npm start

Veya geliştirme modunda:

npm run dev

🛠️ Kullanım

MCP Client Entegrasyonu

Bu server, MCP protokolünü destekleyen herhangi bir AI asistanı ile kullanılabilir. Server başlatıldıktan sonra, AI asistanınız aşağıdaki araçları kullanabilir:

Mevcut Araçlar

1. `uber_arac_turlerini_getir`

Belirli bir konumda mevcut olan Uber araç türlerini getirir.

Parametreler:

latitude (number): Enlem koordinatı
longitude (number): Boylam koordinatı

Örnek:

{
  "name": "uber_arac_turlerini_getir",
  "arguments": {
    "latitude": 41.0082,
    "longitude": 28.9784
  }
}

2. `uber_fiyat_tahmini_al`

Başlangıç ve bitiş noktaları arasında fiyat tahmini alır.

Parametreler:

start_latitude (number): Başlangıç enlem koordinatı
start_longitude (number): Başlangıç boylam koordinatı
end_latitude (number): Bitiş enlem koordinatı
end_longitude (number): Bitiş boylam koordinatı

3. `uber_sure_tahmini_al`

Sürücünün gelme süresini tahmin eder.

Parametreler:

start_latitude (number): Başlangıç enlem koordinatı
start_longitude (number): Başlangıç boylam koordinatı
product_id (string, isteğe bağlı): Belirli araç türü ID'si

4. `uber_arac_cagir`

Yeni bir Uber yolculuğu talep eder.

Parametreler:

product_id (string): Araç türü ID'si
start_latitude (number): Başlangıç enlem koordinatı
start_longitude (number): Başlangıç boylam koordinatı
end_latitude (number, isteğe bağlı): Bitiş enlem koordinatı
end_longitude (number, isteğe bağlı): Bitiş boylam koordinatı
seat_count (number, isteğe bağlı): Yolcu sayısı (1-6 arası)

5. `uber_aktif_yolculuk`

Şu anda aktif olan yolculuğu getirir.

Parametreler: Yok

6. `uber_yolculuk_detaylari`

Belirli bir yolculuğun detaylarını getirir.

Parametreler:

request_id (string): Yolculuk talep ID'si

7. `uber_yolculuk_iptal`

Aktif yolculuğu iptal eder.

Parametreler:

request_id (string): İptal edilecek yolculuk ID'si

8. `uber_yolculuk_gecmisi`

Geçmiş yolculukların listesini getirir.

Parametreler:

offset (number, isteğe bağlı): Başlangıç offset (varsayılan: 0)
limit (number, isteğe bağlı): Maksimum sonuç sayısı (varsayılan: 10)

9. `uber_sofor_puanla`

Tamamlanan yolculuk için şoförü puanlar.

Parametreler:

request_id (string): Yolculuk talep ID'si
rating (number): Puan (1-5 arası)
feedback (string, isteğe bağlı): Geri bildirim

10. `uber_profil_getir`

Kullanıcı profil bilgilerini getirir.

Parametreler: Yok

🔐 Kimlik Doğrulama

Server, Uber OAuth 2.0 akışını destekler. İki kimlik doğrulama yöntemi vardır:

1. Server Token (Sunucu Jetonu)

Basit API erişimi için server token kullanın:

UBER_SERVER_TOKEN=your_server_token_here

2. OAuth 2.0 Flow

Kullanıcı adına işlem yapmak için OAuth flow kullanın:

Authorization URL'ini alın:

const authUrl = uberAPI.getAuthorizationUrl('http://localhost:3000/auth/callback', 'state123');

Kullanıcıyı yetkilendirme sayfasına yönlendirin
Callback'ten authorization code'u alın
Access token için kod ile değiştirin:

const tokens = await uberAPI.exchangeCodeForToken(code, 'http://localhost:3000/auth/callback');
uberAPI.updateAccessToken(tokens.access_token);

🧪 Test ve Geliştirme

Sandbox Modu

Geliştirme ve test için Uber sandbox ortamını kullanın:

UBER_SANDBOX=true
UBER_SANDBOX_API_BASE_URL=https://sandbox-api.uber.com

Sandbox modunda:

Gerçek para tahsil edilmez
Simüle edilmiş sürücü ve yolculuk verileri kullanılır
Tüm API çağrıları güvenli test ortamında gerçekleşir

Test Komutları

# Projeyi test et
npm test

# Kod kalitesini kontrol et
npm run lint

# Kodu biçimlendir
npm run format

📁 Proje Yapısı

uber-mcp/
├── src/
│   ├── index.ts          # Ana MCP server implementasyonu
│   ├── uber-api.ts       # Uber API client ve tip tanımları
├── dist/                 # Derlenmiş JavaScript dosyaları
├── package.json          # Proje bağımlılıkları ve scriptler
├── tsconfig.json         # TypeScript yapılandırması
├── .env.example          # Örnek çevre değişkenleri
└── README.md             # Bu dokümantasyon dosyası

🔧 Yapılandırma

Çevre Değişkenleri

Değişken	Açıklama	Gerekli
`UBER_CLIENT_ID`	Uber uygulama Client ID	✓
`UBER_CLIENT_SECRET`	Uber uygulama Client Secret	✓
`UBER_SERVER_TOKEN`	Uber Server Token	-
`UBER_SANDBOX`	Sandbox modu (true/false)	-
`UBER_API_BASE_URL`	Production API URL	-
`UBER_SANDBOX_API_BASE_URL`	Sandbox API URL	-
`UBER_REDIRECT_URI`	OAuth redirect URI	✓
`UBER_SCOPE`	OAuth scope'ları	✓
`MCP_SERVER_NAME`	MCP server adı	-
`MCP_SERVER_VERSION`	MCP server versiyonu	-
`LOG_LEVEL`	Log seviyesi	-
`DEFAULT_LANGUAGE`	Varsayılan dil	-

Hata Yönetimi

Server kapsamlı hata yönetimi sağlar:

API Hataları: Uber API'sinden gelen hataları yakalar ve Türkçe mesajlarla döner
Validasyon Hataları: Zod şemaları ile giriş validasyonu
Ağ Hataları: Bağlantı sorunlarını yakalar
Kimlik Doğrulama Hataları: OAuth ve token hatalarını yönetir

Türkçe Dil Desteği

Tüm kullanıcı arayüzü ve hata mesajları Türkçe olarak sunulur:

Araç isimleri ve açıklamaları
Durum mesajları
Hata bildirimleri
Yolculuk detayları

🤝 Katkıda Bulunma

Repo'yu fork edin
Feature branch oluşturun (git checkout -b feature/amazing-feature)
Değişikliklerinizi commit edin (git commit -m 'Add some amazing feature')
Branch'inizi push edin (git push origin feature/amazing-feature)
Pull Request oluşturun

📄 Lisans

Bu proje MIT lisansı altında lisanslanmıştır. Detaylar için LICENSE dosyasına bakın.

🐛 Hata Raporlama

Hata bulursanız veya öneriniz varsa:

Issues sayfasından yeni bir issue oluşturun
Hatayı detaylı şekilde açıklayın
Mümkünse hata loglarını ekleyin
Çalışma ortamı bilgilerinizi paylaşın

❓ SSS

S: Server token vs Access token farkı nedir?

C: Server token, uygulamanız adına genel API çağrıları yapmak için kullanılır. Access token ise belirli bir kullanıcı adına işlem yapmak için gereklidir. Yolculuk çağırmak için access token gereklidir.

S: Sandbox modunda gerçek yolculuk çağırabilir miyim?

C: Hayır, sandbox modu sadece test amaçlıdır. Gerçek yolculuk çağırmak için production API'sini kullanmanız gerekir.

S: Hangi şehirlerde Uber kullanabilir miyim?

C: Uber'in aktif olduğu tüm şehirlerde bu MCP server'ı kullanabilirsiniz. Güncel şehir listesi için Uber'in resmi web sitesini kontrol edin.

S: Rate limiting var mı?

C: Evet, Uber API'si rate limiting uygulamaktadır. Server otomatik olarak bu durumu yönetir ve gerekli hata mesajlarını döner.

📞 Destek

Teknik destek için:

GitHub Issues kullanın
Dokümantasyonu kontrol edin
Uber Developer Portal'a başvurun

Not: Bu MCP server, Uber Technologies Inc. tarafından resmi olarak desteklenmemektedir. Bağımsız bir açık kaynak projesidir.

Uber MCP Server

Uber MCP Server

🚗 Özellikler

Temel İşlevler

Teknik Özellikler

📋 Gereksinimler

🔧 Kurulum

1. Bağımlılıkları Yükleyin

2. Çevre Değişkenlerini Ayarlayın

3. Uber Developer Hesabı Kurulumu

4. Projeyi Derleyin

5. Sunucuyu Başlatın

🛠️ Kullanım

MCP Client Entegrasyonu

Mevcut Araçlar

1. uber_arac_turlerini_getir

2. uber_fiyat_tahmini_al

3. uber_sure_tahmini_al

4. uber_arac_cagir

5. uber_aktif_yolculuk

6. uber_yolculuk_detaylari

7. uber_yolculuk_iptal

8. uber_yolculuk_gecmisi

9. uber_sofor_puanla

10. uber_profil_getir

🔐 Kimlik Doğrulama

1. Server Token (Sunucu Jetonu)

2. OAuth 2.0 Flow

🧪 Test ve Geliştirme

Sandbox Modu

Test Komutları

📁 Proje Yapısı

🔧 Yapılandırma

Çevre Değişkenleri

Hata Yönetimi

Türkçe Dil Desteği

🤝 Katkıda Bulunma

📄 Lisans

🐛 Hata Raporlama

❓ SSS

S: Server token vs Access token farkı nedir?

S: Sandbox modunda gerçek yolculuk çağırabilir miyim?

S: Hangi şehirlerde Uber kullanabilir miyim?

S: Rate limiting var mı?

📞 Destek

Reviews

1. `uber_arac_turlerini_getir`

2. `uber_fiyat_tahmini_al`

3. `uber_sure_tahmini_al`

4. `uber_arac_cagir`

5. `uber_aktif_yolculuk`

6. `uber_yolculuk_detaylari`

7. `uber_yolculuk_iptal`

8. `uber_yolculuk_gecmisi`

9. `uber_sofor_puanla`

10. `uber_profil_getir`