YOKATLAS API MCP Sunucusu

🎯 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.8 veya daha yeni bir sürümünün sisteminizde kurulu olması gerekmektedir.
• pip: Python ile birlikte gelen pip paket yöneticisinin çalışır durumda olması gerekir.

⚙️ Kurulum Adımları (Claude Desktop için)

1. uv Kurulumu

• macOS ve Linux için: bash curl -LsSf https://astral.sh/uv/install.sh | sh
• Windows için (PowerShell kullanarak): bash powershell -c "irm https://astral.sh/uv/install.ps1 | iex"
• Alternatif olarak pip ile (tüm platformlar): bash pip install uv

2. fastmcp Komut Satırı Aracının (CLI) Kurulumu

uv pip install fastmcp

3. Proje Dosyalarını Alın

git clone https://github.com/saidsurucu/yokatlas-mcp.git
cd yokatlas-mcp

4. Sunucuya Özel Bağımlılıkların Bilinmesi

Bu sunucunun çalışması için gereken Python kütüphaneleri: * yokatlas-py * beautifulsoup4 * setuptools * fastmcp

🚀 Claude Desktop Entegrasyonu (fastmcp install ile - Önerilen)

fastmcp install yokatlas_mcp_server.py --name "YOKATLAS API Servisi" --with yokatlas-py --with beautifulsoup4 --with setuptools

⚙️ Claude Desktop Manuel Kurulumu (Yapılandırma Dosyası ile - Alternatif)

1. Claude Desktop ayarlarını açın ve "Developer" sekmesine gidin.
2. "Edit Config" düğmesine tıklayarak claude_desktop_config.json dosyasını düzenleyin.
3. mcpServers objesine "YOKATLAS API Servisi" için JSON bloğunu ekleyin.
4. Claude Desktop'ı yeniden başlatın.

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

1. get_associate_degree_atlas_details

   • Açıklama: Belirli bir önlisans programının (Önlisans Atlası) verilen yıldaki tüm detaylarını getirir.
   • Parametreler: program_id: str, year: int

2. get_bachelor_degree_atlas_details

   • Açıklama: Belirli bir lisans programının (Lisans Atlası) verilen yıldaki tüm detaylarını getirir.
   • Parametreler: program_id: str, year: int

3. search_bachelor_degree_programs

   • Açıklama: Çeşitli kriterlere göre lisans programlarını (Lisans Tercih Sihirbazı) arar.
   • Parametreler: uni_adi: str, program_adi: str, puan_turu: str, alt_bs: int, ust_bs: int vb.

4. search_associate_degree_programs

   • Açıklama: Çeşitli kriterlere göre önlisans programlarını (Önlisans Tercih Sihirbazı) arar.
   • Parametreler: uni_adi: str, program_adi: str, alt_puan: float, ust_puan: float vb.

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。