# Taksi MCP Server 🚖

Türkiye'deki taksi hizmetleri için Model Context Protocol (MCP) sunucusu. BiTaksi, iTaksi, Uber ve genel taksi hizmetlerini destekler.

## Özellikler ✨

- **Çoklu Sağlayıcı Desteği**: BiTaksi, iTaksi, Uber ve genel taksi hizmetleri
- **Ücret Tahmini**: Mesafe ve taksi türüne göre ücret hesaplama
- **Taksi Çağırma**: Çeşitli taksi türlerinde yolculuk rezervasyonu
- **Canlı Takip**: Yolculuk durumu ve şoför bilgileri
- **İletişim**: Şoför ile direkt iletişim (arama/SMS)
- **Geçmiş**: Yolculuk geçmişi görüntüleme
- **Türkçe Destek**: Tam Türkçe arayüz ve mesajlar

## Desteklenen Taksi Türleri 🚗

- **Standart Taksi**: Normal şehir taksisi
- **Lüks Taksi**: Konforlu ve geniş araç
- **Büyük Taksi**: 8 kişilik geniş araç
- **Pati Taksi**: Evcil hayvan dostu taksi

## Kurulum 📦

### Gereksinimler

- Node.js 18.0 veya üstü
- npm veya yarn paket yöneticisi

### Kurulum Adımları

1. **Bağımlılıkları yükleyin:**
```bash
npm install
```

2. **Ortam değişkenlerini ayarlayın:**
```bash
cp .env.example .env
# .env dosyasını düzenleyin
```

3. **Projeyi derleyin:**
```bash
npm run build
```

4. **Sunucuyu başlatın:**
```bash
npm start
```

### Geliştirici Modu

```bash
# Watch mode ile geliştirme
npm run dev
```

## Konfigürasyon ⚙️

`.env` dosyasında şu ayarları yapabilirsiniz:

### API Ayarları

```env
# Test modu (API çağrıları yerine mock data)
TEST_MODE=true

# BiTaksi API (gelecekte kullanım için)
BITAKSI_API_KEY=your_api_key
BITAKSI_ENABLED=false

# iTaksi API
ITAKSI_API_KEY=your_api_key
ITAKSI_ENABLED=false

# Uber API
UBER_CLIENT_ID=your_client_id
UBER_CLIENT_SECRET=your_client_secret
UBER_ENABLED=false
```

### Genel Ayarlar

```env
DEFAULT_CITY=istanbul
DEFAULT_COUNTRY_CODE=TR
DEFAULT_CURRENCY=TRY
DEFAULT_LANGUAGE=tr

# Varsayılan konum (İstanbul Taksim)
DEFAULT_LATITUDE=41.0362
DEFAULT_LONGITUDE=28.9841
```

## MCP Tools 🛠️

Sunucu aşağıdaki MCP araçlarını sağlar:

### 1. `taksi_turleri_getir`

Mevcut taksi türlerini listeler.

```json
{
  "saglayici": "bitaksi" // bitaksi, itaksi, uber, genel
}
```

### 2. `ucret_tahmini`

İki konum arası ücret tahmini hesaplar.

```json
{
  "saglayici": "genel",
  "baslangic_enlem": 41.0362,
  "baslangic_boylam": 28.9841,
  "baslangic_adres": "Taksim, İstanbul",
  "hedef_enlem": 41.0082,
  "hedef_boylam": 28.9784,
  "hedef_adres": "Sultanahmet, İstanbul",
  "taksi_turu": "standart"
}
```

### 3. `taksi_cagir`

Taksi çağırır ve yolculuk oluşturur.

```json
{
  "saglayici": "bitaksi",
  "baslangic_enlem": 41.0362,
  "baslangic_boylam": 28.9841,
  "hedef_enlem": 41.0082,
  "hedef_boylam": 28.9784,
  "taksi_turu": "luks",
  "ekstra_ozellikler": ["evcil_hayvan", "klima"]
}
```

### 4. `yolculuk_durumu`

Aktif yolculuğun durumunu sorgular.

```json
{
  "yolculuk_id": "12345",
  "saglayici": "bitaksi"
}
```

### 5. `yolculuk_iptal`

Yolculuğu iptal eder.

```json
{
  "yolculuk_id": "12345",
  "saglayici": "bitaksi",
  "iptal_nedeni": "Planlarım değişti"
}
```

### 6. `yolculuk_gecmisi`

Geçmiş yolculukları listeler.

```json
{
  "saglayici": "genel",
  "limit": 10
}
```

### 7. `surucu_iletisim`

Şoför ile iletişim kurar.

```json
{
  "yolculuk_id": "12345",
  "saglayici": "bitaksi",
  "iletisim_turu": "sms", // arama, sms
  "mesaj": "5 dakika geç kalacağım"
}
```

## API Entegrasyonları 🔌

### Şu Anda Desteklenen

- **Test/Mock Modu**: Tam işlevsel simülasyon
- **Genel Taksi**: Temel taksi işlevleri

### Gelecek Entegrasyonlar

- **BiTaksi API**: Henüz public API yok
- **iTaksi API**: Geliştirici kaynakları araştırılıyor
- **Uber API**: Türkiye desteği kontrol edilecek

## Veri Yapıları 📊

### Konum

```typescript
interface Konum {
  enlem: number;      // latitude
  boylam: number;     // longitude
  adres?: string;     // adres metni
  sehir?: string;     // şehir bilgisi
}
```

### Yolculuk

```typescript
interface Yolculuk {
  id: string;
  saglayici: 'bitaksi' | 'itaksi' | 'uber' | 'genel';
  durum: 'aranıyor' | 'bulundu' | 'yolda' | 'geldi' | 'yolculukta' | 'tamamlandı' | 'iptal';
  baslangic: Konum;
  hedef: Konum;
  taksiTuru: string;
  surucu?: SurucuBilgileri;
  ucret?: number;
  parabirimi: string;
  olusturulma: Date;
  guncelleme: Date;
}
```

### Ücret Tahmini

```typescript
interface UcretTahmini {
  minFiyat: number;
  maxFiyat: number;
  parabirimi: string;
  tahminiSure: number;  // dakika
  mesafe: number;       // kilometre
  taksiTuru: string;
}
```

## Kullanım Örnekleri 💡

### Claude ile Kullanım

```
Taksim'den Sultanahmet'e taksi çağır
```

```
Kadıköy'den Beyoğlu'na ücret tahmini ver
```

```
Aktif yolculuğumun durumunu kontrol et
```

### MCP Client ile

```javascript
// Taksi türlerini listele
await client.callTool("taksi_turleri_getir", {
  saglayici: "bitaksi"
});

// Ücret tahmini al
await client.callTool("ucret_tahmini", {
  baslangic_enlem: 41.0362,
  baslangic_boylam: 28.9841,
  hedef_enlem: 41.0082,
  hedef_boylam: 28.9784,
  taksi_turu: "luks"
});
```

## Hata Yönetimi 🚨

Sunucu şu hata türlerini döndürür:

- **Eksik Parametre**: Gerekli parametreler eksikse
- **API Hatası**: Sağlayıcı API'sinde sorun olursa
- **Konum Hatası**: Geçersiz koordinatlar
- **Yolculuk Bulunamadı**: Belirtilen ID'de yolculuk yoksa

### Hata Formatı

```json
{
  "durum": "hata",
  "hata": "Hata açıklaması",
  "kod": "HATA_KODU"
}
```

## Güvenlik 🔒

- API anahtarları `.env` dosyasında saklanır
- Rate limiting uygulanır
- Konum bilgileri şifrelenir (production'da)
- Kişisel veriler loglanmaz

## Katkıda Bulunma 🤝

1. Fork yapın
2. Feature branch oluşturun (`git checkout -b feature/yeni-ozellik`)
3. Değişikliklerinizi commit edin (`git commit -am 'Yeni özellik eklendi'`)
4. Branch'inizi push edin (`git push origin feature/yeni-ozellik`)
5. Pull Request oluşturun

## Roadmap 🗺️

- [ ] BiTaksi API entegrasyonu
- [ ] iTaksi API entegrasyonu  
- [ ] Uber API entegrasyonu
- [ ] Gerçek zamanlı konum takibi
- [ ] Push notification desteği
- [ ] Ödeme entegrasyonu
- [ ] Multi-language desteği
- [ ] Mobile app entegrasyonu

## Lisans 📄

MIT License - detaylar için LICENSE dosyasına bakınız.

## İletişim 📞

- GitHub: [Issue açın](https://github.com/your-repo/taksi-mcp/issues)
- Email: support@yourcompany.com

## Teşekkürler 🙏

Bu proje [Model Context Protocol](https://modelcontextprotocol.io/) ve Türkiye'deki taksi sağlayıcıları sayesinde mümkün olmuştur.

---

**Not**: Bu proje henüz development aşamasındadır. Production ortamında kullanmadan önce tüm API entegrasyonlarını test edin.