YOKATLAS API MCP Sunucusu

Bu proje, YÖKATLAS verilerine erişimi sağlayan yokatlas-py Python kütüphanesini kullanarak bir FastMCP sunucusu oluşturur. Bu sayede, YÖKATLAS API fonksiyonları, Model Context Protocol (MCP) destekleyen LLM (Büyük Dil Modeli) uygulamaları ve diğer istemciler tarafından araç (tool) olarak kullanılabilir hale gelir.

🎯 Temel Özellikler

• YÖKATLAS verilerine programatik erişim için standart bir MCP arayüzü.
• Lisans ve Önlisans program detaylarını getirme.
• Lisans ve Önlisans programları için kapsamlı arama yapabilme (Tercih Sihirbazı).
• Claude Desktop uygulaması ile kolay entegrasyon.

📋 Ön Gereksinimler

• Python Sürümü: Python 3.12 veya daha yeni bir sürümünün sisteminizde kurulu olması gerekmektedir. Python'ı python.org adresinden indirebilirsiniz.
• pip: Python ile birlikte gelen pip paket yöneticisinin çalışır durumda olması gerekir.

{
  "mcpServers": {
    "YOKATLAS API Servisi": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/saidsurucu/yokatlas-mcp",
        "yokatlas-mcp"
      ]
    }
  }
}

🛠️ Kullanılabilir Araçlar (MCP Tools)

Bu FastMCP sunucusu aşağıdaki araçları sunar:

🔍 Akıllı Arama Araçları (Smart Search Tools)

1. search_bachelor_degree_programs ⭐ YENİ Smart Search

   • Açıklama: Lisans programları için akıllı arama (Fuzzy matching ile)
   • Özellikler:
     • 🧠 Fuzzy Matching: "boğaziçi" → "BOĞAZİÇİ ÜNİVERSİTESİ"
     • 🔎 Kısmi Eşleştirme: "bilgisayar" → tüm bilgisayar programları
     • 📝 Kullanıcı Dostu Parametreler: university, program, city
     • ✅ Type-Safe Validation: Pydantic modelleri ile
   • Parametreler:
     • university (str): Üniversite adı (fuzzy matching)
     • program (str): Program adı (kısmi eşleştirme)
     • city (str): Şehir adı
     • score_type (str): Puan türü (SAY, EA, SOZ, DIL)
     • university_type (str): Üniversite türü (Devlet, Vakıf)
     • fee_type (str): Ücret durumu
     • education_type (str): Öğretim türü
     • results_limit (int): Sonuç sayısı (varsayılan: 50)

2. search_associate_degree_programs ⭐ YENİ Smart Search

   • Açıklama: Önlisans programları için akıllı arama (Fuzzy matching ile)
   • Özellikler:
     • 🧠 Fuzzy Matching: "anadolu" → "ANADOLU ÜNİVERSİTESİ"
     • 🔎 Kısmi Eşleştirme: "turizm" → tüm turizm programları
     • 📝 Kullanıcı Dostu Parametreler: university, program, city
     • ⚡ TYT Puan Sistemi: Önlisans için özel puan sistemi
   • Parametreler:
     • university (str): Üniversite adı (fuzzy matching)
     • program (str): Program adı (kısmi eşleştirme)
     • city (str): Şehir adı
     • university_type (str): Üniversite türü
     • fee_type (str): Ücret durumu
     • education_type (str): Öğretim türü
     • results_limit (int): Sonuç sayısı (varsayılan: 50)

📊 Atlas Detay Araçları

1. get_bachelor_degree_atlas_details

   • Açıklama: Belirli bir lisans programının YOKATLAS Atlas'tan kapsamlı detaylarını getirir
   • Parametreler:
     • yop_kodu (str): Program YÖP kodu (örn: '102210277')
     • year (int): Veri yılı (örn: 2024, 2023)
   • Döndürülen Veriler:
     • Genel program bilgileri ve istatistikleri
     • Kontenjan, yerleşme ve puan verileri
     • Öğrenci demografik dağılımları
     • Akademik kadro ve tesis bilgileri
     • Geçmiş yerleşme trendleri

2. get_associate_degree_atlas_details

   • Açıklama: Belirli bir önlisans programının YOKATLAS Atlas'tan kapsamlı detaylarını getirir
   • Parametreler:
     • yop_kodu (str): Program YÖP kodu (örn: '120910060')
     • year (int): Veri yılı (örn: 2024, 2023)
   • Döndürülen Veriler:
     • Genel program bilgileri ve istatistikleri
     • Kontenjan, yerleşme ve puan verileri
     • Öğrenci demografik dağılımları
     • Akademik kadro ve tesis bilgileri
     • Geçmiş yerleşme trendleri

🚀 Kullanım Örnekleri

# Claude Desktop'ta kullanım örnekleri:

# 1. Fuzzy matching ile üniversite arama
"Boğaziçi üniversitesinin bilgisayar mühendisliği programlarını bul"
# → "boğaziçi" otomatik olarak "BOĞAZİÇİ ÜNİVERSİTESİ" ile eşleşir

# 2. Kısmi program adı ile arama  
"İstanbul'daki tüm mühendislik programlarını listele"
# → "mühendislik" kelimesi ile başlayan tüm programları bulur

# 3. Şehir bazlı arama
"Ankara'daki devlet üniversitelerindeki tıp programlarını göster"
# → Şehir, üniversite türü ve program filtresi ile arama

# 4. Önlisans programları
"Anadolu üniversitesinin turizm ile ilgili önlisans programlarını bul"
# → Fuzzy matching + kısmi eşleştirme ile önlisans arama

# 5. Atlas detayları
"102210277 YÖP kodlu programın 2024 yılı detaylarını getir"
# → Program atlas detayları: kontenjan, yerleşme, puan istatistikleri

# 6. Program kodu bulma ve atlas detayları
"Boğaziçi bilgisayar mühendisliğini bul, sonra atlas detaylarını getir"
# → Önce arama ile YÖP kodunu bul, sonra atlas detaylarını çek

📜 Lisans

Bu proje MIT Lisansı altında lisanslanmıştır.