İzmir Ulaşım
About
Access real-time public transportation data for the city of İzmir, allowing AI assistants to query routes and schedules.
Details
- Author
- ogulcanakca
- Categories
- Other, Developer Tools
Jump to
Setup
Install İzmir Ulaşım in your MCP client (Claude Desktop, Cursor, Windsurf, and others).
Repository: https://github.com/ogulcanakca/izmir-ulasim-mcp
Follow the installation instructions in the repository README, then restart your MCP client.
İzmir toplu taşıma verilerine erişim sağlayan bir Model Bağlam Protokolü (MCP) sunucusu, AI asistanlarının şehir ulaşım verilerini ve analizlerini sorgulamasına olanak tanır.npm üzerindende erişebilirsiniz.
Bu MCP sunucusu, İzmir'inAçık Veri PortalındakiESHOT veritabanına bağlanır ve anlık otobüs konumlarını, durak bilgilerini, hat güzergahlarını, sefer saatlerini ve yaklaşan araç verilerini almak için çeşitli araçlar sunar. Sunucu, durağa yaklaşan otobüsleri getirme, hat üzerindeki anlık otobüs konumlarını sorgulama, belirli hat ve durak kombinasyonları için yaklaşan araçları filtreleme, durak arama, hat arama ve sefer saatlerini sorgulama gibi işlevler sağlar. Claude Desktop ve Cursor gibi MCP uyumlu AI asistanlarıyla veya agentic yapılarla çalışmak üzere tasarlanmıştır veAçık Veri Portalındakianlık ve canlı ESHOT (şimdilik sadece ESHOT) verileriyle ilgili doğal dil sorguları yapmanızı sağlar.
Bu MCP sunucusu, aşağıdaki araçları (tool) içermektedir:
- duraga_yaklasan_otobusleri_getir(stop_id): Belirtilen bir durak ID'sine yaklaşmakta olan tüm otobüslerin bilgilerini getirir.
- hattin_anlik_otobus_konumlarini_getir(line_id): ID'si girilen bir hatta ait tüm otobüslerin anlık konum bilgilerini getirir.
- hattin_duraga_yaklasan_otobuslerini_getir(line_id, stop_id): Belirtilen bir hattın, belirtilen durağa yaklaşmakta olan otobüslerini getirir.
- durak_ara(durak_adi): Adında belirtilen metin geçen otobüs duraklarını arar.
- izban_istasyon_ara(istasyon_adi): Adında belirtilen metin geçen İZBAN istasyonlarını arar.
- izban_sefer_saatlerini_getir(kalkis_istasyon_id, varis_istasyon_id): Belirtilen iki İZBAN istasyonu arasındaki sefer saatlerini getirir.
- izban_tutar_hesapla(binis_istasyon_id, inis_istasyon_id, aktarma_sayisi): 'Gittiğin Kadar Öde' sistemine göre İZBAN yolculuk ücretini hesaplar.
- hat_ara(hat_bilgisi): Adında veya güzergahında belirtilen metin geçen otobüs hatlarını arar.
- hat_sefer_saatlerini_ara(hat_no): Belirtilen hat numarasına göre otobüs sefer saatlerini arar.
- hat_guzergah_koordinatlarini_getir(hat_no): Belirtilen hat numarasına ait güzergahın koordinat (enlem/boylam) bilgilerini getirir.
- hat_detaylarini_ara(hat_bilgisi): Adında veya güzergahında belirtilen metni içeren hatların çalışma saatleri gibi detaylı bilgilerini arar.
- en_yakin_duraklari_bul(latitude, longitude, tur): Verilen enlem ve boylama en yakın otobüs duraklarını veya İZBAN istasyonlarını bulur.
- konumumu_al(): Tarayıcı üzerinden kullanıcının hassas coğrafi konumunu alır.
- metro_istasyonlarini_getir(): İzmir metrosuna ait tüm istasyonların bir listesini döndürür.
- metro_sefer_saatlerini_getir(): İzmir metrosuna ait tüm sefer saatlerini getirir.
- metro_istasyonlari_arasi_mesafe_hesapla(kalkis_istasyon_adi, varis_istasyon_adi): İki metro istasyonu arasındaki mesafeyi metre cinsinden hesaplar.
- tramvay_hatlarini_getir(): İzmir tramvayına ait tüm hatların bir listesini döndürür.
- tramvay_istasyonlarini_getir(hat_id): Belirtilen hat ID'sine sahip tramvay hattının tüm istasyonlarını getirir.
- tramvay_seferlerini_getir(hat_id): Belirtilen hat ID'sine göre tramvay sefer saatlerini getirir.
- karsiyaka_tram_duraklar_arasi_mesafe_hesapla(kalkis_istasyon_adi, varis_istasyon_adi): İki Karşıyaka tramvay istasyonu arasındaki mesafeyi metre cinsinden hesaplar.
- konak_tram_1_duraklar_arasi_mesafe_hesapla(kalkis_istasyon_adi, varis_istasyon_adi): Kara tarafı olan yöndeki iki Konak tramvay durağı arasındaki mesafeyi metre cinsinden hesaplar.
- konak_tram_2_duraklar_arasi_mesafe_hesapla(kalkis_istasyon_adi, varis_istasyon_adi): Deniz tarafı olan yöndeki iki Konak tramvay durağı arasındaki mesafeyi metre cinsinden hesaplar.
- cigli_tram_duraklar_arasi_mesafe_hesapla(kalkis_istasyon_adi, varis_istasyon_adi): İki Çiğli tramvay durağı arasındaki mesafeyi metre cinsinden hesaplar.
- Python 3.11+
- requests
- mcp-cli
- fastmcp
- pandas
- numpy
- flask
- pyarrow
- fastparquet
git clone https://github.com/ogulcanakca/izmir-ulasim-mcp.git cd izmir-ulasim-mcp
Sunucuyu Claude Desktop ile kullanmak için:
- macOS:~/Library/Application Support/Claude/claude_desktop_config.json
- Windows:%APPDATA%\Claude\claude_desktop_config.json
- macOS:$HOME/.cursor/mcp.json
- Windows:%USERPROFILE%\.cursor\mcp.json
{ "mcpServers": { "izmir_ulasim": { "command": "python", "args": ["path\\to\\izmir_ulasim_main.py"] } } }
{ "mcpServers": { "izmir_ulasim_npm": { "command": "npx", "args": ["-y", "izmir-ulasim-mcp"] } } }
Bu proje, İzmir'in ulaşım verilerini daha erişilebilir kılmak için bir başlangıç noktasıdır. Gelecekte eklenmesi planlanan ve topluluk tarafından katkı sağlanabilecek bazı özellikler şunlardır:
- Tahmini Varış Süresi (ETA) Hesaplama:Kalan durak sayısını, otobüsün anlık hızını veya ortalama durak arası seyahat süresini kullanarak durağa varış için tahmini bir süre (dakika cinsinden) hesaplamak.
- Akıllı Filtreleme:Araçlaraengelli_uygunlugu_olsun=Trueveyabisiklet_aparati_olsun=Truegibi parametreler ekleyerek daha detaylı ve ihtiyaca yönelik sorgular yapılmasını sağlamak.
- Harita Üzerinde Görselleştirme:Anlık konum veya güzergah sorguları için, çıktıda doğrudan bir harita servisinin (Google Maps, OpenStreetMap vb.) linkini veya statik bir harita görselini oluşturmak.
- Diğer Ulaşım Türleri:ESHOT'a ek olarak, İzmir'deki diğer toplu taşıma ağları olanİzban, Metro ve Vapur (İzdeniz)için de benzer araçlar geliştirerek sunucuyu tam kapsamlı bir "İzmir Ulaşım" aracına dönüştürmek.
- Yol Tarifi ve Rota Planlama:Kullanıcının "A noktasından B noktasına nasıl giderim?" sorusuna yanıt verebilecek, en uygun (direkt veya aktarmalı) rotayı öneren gelişmiş bir araç eklemek.
- Servis Duyuruları:İlgili kurumların anlık arıza, gecikme veya güzergah değişikliği duyurularını sorgulayacak bir araç entegre etmek.
- Kişiselleştirme ve Hafıza:Asistanın, kullanıcının sık kullandığı "ev", "iş" gibi konumları veya favori hatlarını öğrenerek daha kişisel yanıtlar vermesini sağlamak.
Chia Health MCP Server — Patient workflow integration for a licensed US telehealth platform. Browse GLP-1 medications (semaglutide, tirzepatide), peptide therapies (sermorelin, NAD+, glutathione), and longevity treatments. Check eligibility, complete intake, sign consents, and manage treatment plans. 30 tools, HIPAA-compliant. All prescriptions evaluated by licensed US healthcare providers and delivered from FDA-regulated pharmacies across 50 states + DC.
Broker + MCP server for last-bidder-wins games on Solana — agents register, auto-fund a Privy wallet, and bid via streamable HTTP
AI-powered no-code app builder with 17 MCP tools — create projects, generate pages from natural language, AI text/image generation (GPT, Claude, Gemini, 14+ models), page CRUD, workflow execution, publish & version control. SSE transport, API key auth.
An mcp server for your food ordering needs.
Agent-to-Agent handoff certification for multi-agent systems — validates context preservation, verifies agent capabilities before handoff, logs transfer chains, and ensures no data loss in agent orchestration.
Unified MCP & skill management gateway with progressive disclosure. Manages multiple MCP servers as Agent Apps, loading tool schemas on demand for 99% context token savings. Shared across Claude Code, Codex, OpenCode and more.
A collection of Model Context Protocol (MCP) servers for various tasks and integrations, supporting both Python and Node.js environments.
Open-souSecurely feeds real security refreshed rules into Cursor, Claude Code, and Windsurf — zero config, no API key.
Health intelligence MCP — access biomarkers, biological age, and personalized longevity action plans from your Aniva profile.
Real-time stock heatmaps and investment tools delivered as interactive React components.
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
