IzmirMCP — Izmir Public Transport MCP Server

IzmirMCP, Izmir toplu tasima verilerini (IZBAN, ESHOT, Tramvay, Metro, Vapur/Izdeniz, Tren) Model Context Protocol (MCP) uzerinden sunan acik kaynakli bir TypeScript sunucusudur. AI asistanlari (Claude dahil) ve diger MCP istemcileri icin gerçek zamanli otobus konumlari, sefer saatleri ve durak bilgilerini kolayca erisilebilir hale getirir.

SEO odakli anahtar kavramlar: Izmir toplu tasima API, gerçek zamanli otobus konumu, Izmir metro saatleri, IZBAN seferleri, ESHOT duraklari, MCP server, Model Context Protocol.

Neler Sunar?

• Izmir toplu tasima sistemleri icin tek noktadan MCP entegrasyonu
• Gerçek zamanli veriler: otobus konumlari ve yaklaşan seferler
• Sefer saatleri, istasyon/durak listeleri, hat aramalari
• Moduler yapi: Izban, Eshot, Metro, Tramvay, Vapur ve Tren araclari
• Node.js 18+ uyumlu, TypeScript ile gelistirilmis

Desteklenen Sistemler ve Veri Tipleri

Kurulum ve Hizli Baslangic

NPM ile Calistirma (onerilen)

npx izmir-mcp

Alternatif olarak global kurulum:

npm install -g izmir-mcp
izmir-mcp

IzmirMCP, MCP stdio transport ile calisir; HTTP portu acmaz. MCP istemciniz bu sureci stdio uzerinden yonetir.

Kaynaktan Kurulum

git clone https://github.com/halilcengel/IzmirMCP.git
cd IzmirMCP
npm install
npm run build
npm start

MCP Istemcisi Yapilandirmasi (Claude, etc.)

{
  "mcpServers": {
    "izmir-mcp": {
      "command": "npx",
      "args": ["izmir-mcp"]
    }
  }
}

Ornek Kullanim Senaryolari

Asagidaki ornekler, bir MCP istemcisinde Izmir toplu tasima verilerini nasil sorgulayabileceginizi gosterir:

ESHOT durak arama:
"Alsancak" bolgesindeki ESHOT duraklarini getir.

Hat uzerindeki otobus konumlari:
Hat 551 icin tum otobuslerin anlik GPS konumlarini getir.

Duraga yaklasan otobusler:
Durak ID 12345 icin yaklasan otobusleri listele.

IZBAN seferleri:
Aliağa (123) ile Alsancak (456) arasindaki IZBAN seferlerini getir.

Metro sefer sikligi:
Izmir metro sefer sikligini getir.

Vapur saatleri:
Karsiyaka - Alsancak arasi hafta ici vapur saatlerini getir.

Isterseniz, bu istemleri MCP arac cagrisina da cevirtebilirsiniz.

Araclar (Tools)

IZBAN

• `get-izban-stations` — Istasyon listesi
• `get-izban-departures` — Iki istasyon arasinda planli seferler
• `get-izban-fare-tariff` — Ucret tarifesi hesaplama

ESHOT

• `get-eshot-stations` — Durak arama
• `get-eshot-lines` — Hat arama
• `get-line-approaching-buses` — Belirli duraga yaklasan otobusler
• `get-line-bus-locations` — Hat uzerindeki tum otobuslerin GPS konumu
• `get-station-approaching-buses` — Duraga yaklasan tum otobusler
• `get-nearby-stations-by-coords` — Koordinata gore yakindaki duraklar

Tramvay

• `get-tram-lines` — Tum hatlar
• `get-tram-stations-by-sefer-id` — Sefer ID ile istasyonlar
• `get-tram-sefer-frequency-by-sefer-id` — Sefer sikligi

Metro

• `get-metro-stations` — Istasyon listesi
• `get-metro-sefer-frequencies` — Sefer sikligi

Vapur (Izdeniz)

• `get-ferry-timetables` — Kalkis/varis ve gun tipine gore hareket saatleri
• `get-ferry-timetables-by-pier` — Iskele bazli hareket saatleri
• `get-ferry-working-days` — Calisma gunleri
• `get-ferry-piers` — Iskele bilgileri

Tren

• `get-train-stations` — Tren gar listesi

Ortam Degiskenleri

Veri Kaynaklari

Veriler, Izmir Buyuksehir Belediyesi acik API ve acik veri kaynaklarindan alinmaktadir:

• https://openapi.izmir.bel.tr/api
• https://acikveri.bizizmir.com

Ekran Goruntuleri

Katkida Bulunma

Katkilar memnuniyetle karsilanir:

1. Depoyu fork'layin

2. Yeni bir branch acin (`git checkout -b ozellik/yenilik`)

3. Degisiklikleri commit'leyin

4. Branch'i push'layin

5. Pull Request olusturun

Lisans

Bu proje ISC Lisansi altinda lisanslanmistir.

Sorumluluk Reddi

Bu proje Izmir Buyuksehir Belediyesi'nin resmi bir uygulamasi degildir. Veriler kamuya acik kaynaklardan alinmaktadir. Dogruluk ve guncellik konusunda garanti verilmez.