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:Copy
- Windows için (PowerShell kullanarak):
PowerShell'i açın ve aşağıdaki komutu çalıştırın:Copy
- Alternatif olarak
pip
ile (tüm platformlar): Eğer yukarıdaki yöntemler işe yaramazsa veyapip
kullanmayı tercih ederseniz:Kurulumdan sonra,Copyuv
komutunun sisteminiz tarafından tanınması için terminalinizi yeniden başlatmanız veyaPATH
ortam değişkeninizi güncellemeniz (örneğin, Linux/macOS içinsource $HOME/.cargo/env
veyasource $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:
Eğer uv
kurulumunda sorun yaşadıysanız veya pip
kullanmak isterseniz, fastmcp
'yi pip
ile de kurabilirsiniz:
fastmcp --version
komutu ile kurulumu doğrulayabilirsiniz.
3. Proje Dosyalarını Alın
Bu YOKATLAS MCP sunucusunun kaynak kodlarını bilgisayarınıza indirin.
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:
- Terminalde
yokatlas_mcp_server.py
dosyasının bulunduğuyokatlas-mcp
dizininde olduğunuzdan emin olun. - Aşağıdaki komutu çalıştırın:Copy
--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.
- 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.
- 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
- macOS:
- 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ğermcpServers
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:Önemli Notlar:Copy- 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). Deponuzuhttps://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 sisteminizdeuv
'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.
- Eğer
- 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:
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
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
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çinyokatlas_mcp_server.py
script'indeki tool tanımına bakınız.)
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çinyokatlas_mcp_server.py
script'indeki tool tanımına bakınız.)
📜 Lisans
Bu proje MIT Lisansı altında lisanslanmıştır.
This server cannot be installed
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.
Related MCP Servers
- -securityFlicense-qualityA 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 contextLast updated -375JavaScript
Fused MCP Agentsofficial
-securityAlicense-qualityA 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 -23MIT License- -securityAlicense-qualityAn 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 -177PythonMIT License
- AsecurityAlicenseAqualityAn MCP server that enables LLMs to interact with Moodle platforms to manage courses, students, assignments, and quizzes through natural language commands.Last updated -77JavaScriptMIT License