YOKATLAS API MCP Server

by saidsurucu
MIT License
3
  • Apple
  • Linux

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.8 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.

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

Claude Desktop uygulamasına yükleme yapabilmek için öncelikle uv ve fastmcp komut satırı araçlarını kurmanız, ardından proje dosyalarını almanız gerekmektedir.

1. uv Kurulumu

uv, Rust ile yazılmış son derece hızlı bir Python paket kurucusu, çözümleyicisi ve sanal ortam yöneticisidir. fastmcp kurulumu ve Claude Desktop entegrasyonu için uv kullanılması önerilmektedir.

  • macOS ve Linux için: Terminali açın ve aşağıdaki komutu çalıştırın:
    curl -LsSf https://astral.sh/uv/install.sh | sh
  • Windows için (PowerShell kullanarak): PowerShell'i açın ve aşağıdaki komutu çalıştırın:
    powershell -c "irm https://astral.sh/uv/install.ps1 | iex"
  • Alternatif olarak pip ile (tüm platformlar): Eğer yukarıdaki yöntemler işe yaramazsa veya pip kullanmayı tercih ederseniz:
    pip install uv
    Kurulumdan sonra, uv komutunun sisteminiz tarafından tanınması için terminalinizi yeniden başlatmanız veya PATH ortam değişkeninizi güncellemeniz (örneğin, Linux/macOS için source $HOME/.cargo/env veya source $HOME/.bashrc, source $HOME/.zshrc gibi) gerekebilir. uv --version komutu ile kurulumu doğrulayabilirsiniz.

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

fastmcp CLI, MCP sunucularını yönetmek ve özellikle fastmcp install komutu ile Claude Desktop'a kurmak için gereklidir. uv kullanarak kurulması önerilir:

uv pip install fastmcp

Eğer uv kurulumunda sorun yaşadıysanız veya pip kullanmak isterseniz, fastmcp'yi pip ile de kurabilirsiniz:

pip install fastmcp

fastmcp --version komutu ile kurulumu doğrulayabilirsiniz.

3. Proje Dosyalarını Alın

Bu YOKATLAS MCP sunucusunun kaynak kodlarını bilgisayarınıza indirin.

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

Bu README.md dosyasının ve yokatlas_mcp_server.py script'inin bulunduğu dizine cd komutu ile geçmiş olacaksınız.

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

Bu sunucunun (yokatlas_mcp_server.py) çalışması için bazı Python kütüphanelerine ihtiyacı vardır. Bu kütüphaneler Claude Desktop entegrasyonu sırasında (fastmcp install veya manuel kurulumda) belirtilecektir:

  • yokatlas-py
  • beautifulsoup4
  • setuptools
  • fastmcp (sunucunun kendisi için de gereklidir)

(Eğer sunucuyu bağımsız olarak geliştirmek veya test etmek isterseniz, bir sanal ortam (python -m venv .venv & .venv/bin/activate veya .venv\Scripts\activate) oluşturup bu bağımlılıkları uv pip install fastmcp yokatlas-py beautifulsoup4 setuptools komutuyla kurabilirsiniz.)

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

Yukarıdaki kurulum adımlarını tamamladıktan sonra, bu sunucuyu Claude Desktop uygulamasına kalıcı bir araç olarak eklemenin en kolay yolu fastmcp install komutunu kullanmaktır:

  1. Terminalde yokatlas_mcp_server.py dosyasının bulunduğu yokatlas-mcp dizininde olduğunuzdan emin olun.
  2. Aşağıdaki komutu çalıştırın:
    fastmcp install yokatlas_mcp_server.py --name "YOKATLAS API Servisi" --with yokatlas-py --with beautifulsoup4 --with setuptools
    • --name "YOKATLAS API Servisi": Araç Claude Desktop'ta bu isimle görünecektir.
    • --with yokatlas-py --with beautifulsoup4 --with setuptools: Sunucunun çalışması için gereken Python bağımlılıklarını belirtir. fastmcp kendisi de bu ortama dahil edilecektir (fastmcp install bunu otomatik olarak yönetir).

Bu komut, uv kullanarak sunucunuz için izole bir Python ortamı oluşturacak, belirtilen bağımlılıkları kuracak ve aracı Claude Desktop uygulamasına kaydedecektir. Kurulum tamamlandıktan sonra "YOKATLAS API Servisi" Claude Desktop uygulamanızda kullanılabilir olacaktır.

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

fastmcp install komutunu kullanmak yerine, sunucunuzu Claude Desktop uygulamasına manuel olarak da ekleyebilirsiniz. Bu yöntem, yapılandırma dosyasını doğrudan düzenlemeyi içerir ve daha fazla kontrol sağlar.

Uyarı: Yapılandırma dosyasını düzenlerken dikkatli olun. Hatalı bir yapılandırma Claude Desktop uygulamasının düzgün çalışmamasına neden olabilir.

  1. Claude Desktop Ayarlarını Açın: Claude Desktop uygulamasında, menü çubuğundan (macOS'te üst menü, Windows'ta genellikle uygulama içi menü) "Settings..." (Ayarlar...) seçeneğine gidin.
  2. Geliştirici Ayarlarına Girin ve Yapılandırma Dosyasını Düzenleyin: Açılan ayarlar penceresinde sol taraftaki menüden "Developer" (Geliştirici) sekmesine tıklayın. Ardından "Edit Config" (Yapılandırmayı Düzenle) düğmesine tıklayın.Bu işlem, aşağıdaki konumlarda bulunan claude_desktop_config.json dosyasını oluşturacak (eğer yoksa) ve dosya gezgininde gösterecektir:
    • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
    • Windows: %APPDATA%\Claude\claude_desktop_config.json
  3. Yapılandırma Dosyasını Düzenleyin: claude_desktop_config.json dosyasını bir metin düzenleyici ile açın. Dosyanın içeriği aşağıdaki gibi bir yapıda olacaktır. mcpServers objesine (eğer mcpServers objesi yoksa, önce onu ve kapsayan {} parantezlerini oluşturun) "YOKATLAS API Servisi" için aşağıdaki JSON bloğunu ekleyin. JSON'ı belirtmek için ```json ... ``` kullanıyoruz:
    { "mcpServers": { // ... (varsa diğer sunucu tanımlamalarınız burada kalabilir, virgülle ayırarak) ... "YOKATLAS API Servisi": { "command": "uv", "args": [ "run", "--with", "beautifulsoup4", "--with", "fastmcp", "--with", "setuptools", "--with", "yokatlas-py", "fastmcp", "run", "/tam/proje/yolunuz/yokatlas-mcp/yokatlas_mcp_server.py" ] } } }
    Önemli Notlar:
    • Eğer mcpServers objesi içinde zaten başka sunucularınız varsa, "YOKATLAS API Servisi" girdisini onlarla birlikte, virgülle ayırarak ekleyin. JSON formatının geçerli olduğundan emin olun (örneğin, girdiler arasında virgül olmalı, son girdiden sonra virgül olmamalı).
    • "/tam/proje/yolunuz/yokatlas-mcp/yokatlas_mcp_server.py" kısmını, yokatlas_mcp_server.py dosyasının sisteminizdeki tam ve doğru yolu ile değiştirmeyi unutmayın. Örneğin: "/Users/kullaniciadiniz/Documents/GitHub/yokatlas-mcp/yokatlas_mcp_server.py" (macOS/Linux) veya "C:\\Users\\kullaniciadiniz\\Documents\\GitHub\\yokatlas-mcp\\yokatlas_mcp_server.py" (Windows - JSON içinde çift ters taksim \\ kullanıldığına dikkat edin). Deponuzu https://github.com/saidsurucu/yokatlas-mcp.git adresinden klonladıysanız ve örneğin Belgelerim/GitHub altına klonladıysanız, yol "/Users/saidsurucu/Documents/GitHub/yokatlas-mcp/yokatlas_mcp_server.py" şeklinde olacaktır (kendi kullanıcı adınız ve klonlama yerinize göre uyarlayın).
    • Bu yapılandırma uv komutunu kullandığı için sisteminizde uv'nin kurulu ve PATH'e ekli olması gerekir (bkz: "Kurulum Adımları > 1. uv Kurulumu").
    • Gerekli Python paketleri (beautifulsoup4, fastmcp, setuptools, yokatlas-py) uv run --with ... komutu sayesinde otomatik olarak yönetilecektir.
  4. Claude Desktop'ı Yeniden Başlatın: Yapılandırma dosyasını kaydedip kapattıktan sonra, değişikliklerin etkili olması için Claude Desktop uygulamasını tamamen kapatıp yeniden başlatın.

Başarılı bir kurulumdan sonra, Claude Desktop uygulamasında giriş kutusunun sağ alt köşesinde çekiç (🛠️) simgesini ve tıkladığınızda "YOKATLAS API Servisi" araçlarını görmelisiniz.

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

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

  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 (örn: SAY, EA), alt_bs: int, ust_bs: int vb. (Detaylar için yokatlas_mcp_server.py script'indeki tool tanımına bakınız.)
  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. (Detaylar için yokatlas_mcp_server.py script'indeki tool tanımına bakınız.)

📜 Lisans

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

-
security - not tested
A
license - permissive license
-
quality - not tested

Provides an MCP interface for accessing YOKATLAS (Turkish Higher Education Council Atlas) data, enabling LLM applications like Claude to search and retrieve details about undergraduate and associate degree programs in Turkey.

  1. 🎯 Temel Özellikler
    1. 📋 Ön Gereksinimler
      1. ⚙️ Kurulum Adımları (Claude Desktop için)
        1. 1. uv Kurulumu
        2. 2. fastmcp Komut Satırı Aracının (CLI) Kurulumu
        3. 3. Proje Dosyalarını Alın
        4. 4. Sunucuya Özel Bağımlılıkların Bilinmesi
      2. 🚀 Claude Desktop Entegrasyonu (fastmcp install ile - Önerilen)
        1. ⚙️ Claude Desktop Manuel Kurulumu (Yapılandırma Dosyası ile - Alternatif)
          1. 🛠️ Kullanılabilir Araçlar (MCP Tools)
            1. 📜 Lisans

              Related MCP Servers

              • -
                security
                F
                license
                -
                quality
                A MCP server that exposes OpenAPI schema information to LLMs like Claude. This server allows an LLM to explore and understand large OpenAPI schemas through a set of specialized tools, without needing to load the whole schema into the context
                Last updated -
                37
                5
                JavaScript
                • Apple
                • Linux
              • -
                security
                A
                license
                -
                quality
                A Python-based MCP server that allows Claude and other LLMs to execute arbitrary Python code directly through your desktop Claude app, enabling data scientists to connect LLMs to APIs and executable code.
                Last updated -
                23
                MIT License
                • Apple
                • Linux
              • -
                security
                A
                license
                -
                quality
                An MCP server that provides tools to load and fetch documentation from any llms.txt source, giving users full control over context retrieval for LLMs in IDE agents and applications.
                Last updated -
                177
                Python
                MIT License
                • Apple
              • A
                security
                A
                license
                A
                quality
                An MCP server that enables LLMs to interact with Moodle platforms to manage courses, students, assignments, and quizzes through natural language commands.
                Last updated -
                7
                7
                JavaScript
                MIT License
                • Apple

              View all related MCP servers

              ID: lwmwziqv8l