iu-mcp
iu-mcp exposes 12 MCP tools that give an AI assistant structured access to Istanbul University public academic data, plus local change tracking and notification-queue management.
Query the official 2026–27 academic calendar by term, category, keyword, and upcoming dates.
Fetch SKS cafeteria menus for today, tomorrow, or a date, up to 7 days, filtered by meal.
List announcements, news, and events from 9 IU faculties with type, count, keyword, and faculty filters.
Track announcement changes locally and create subscription profiles by faculty, department, or exact course codes.
Manage a local notification queue by listing/leasing ready notifications and recording delivery results for external senders such as Telegram; the tools do not scan or send messages themselves.
Look up EBS course syllabi: code, ECTS, instructor, objectives, weekly topics, and assessment.
Retrieve 2026–27 curriculum by program, year, and semester.
Browse faculty info pages such as internships, FAQ, Erasmus, and exchange programs; get class-schedule links and notes (currently BBTF layout only).
Calculate semester and cumulative GPA offline with ECTS weighting and optional custom grade scales.
Web-sourced responses include official source links and retrieval times; only public pages are used, with no student login or official university affiliation.
Provides Telegram notification delivery for tracked faculty and course announcement changes, sending queued updates via a Telegram bot and chat ID and recording delivery results.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@iu-mcp güz finali ne zaman, kaç gün kaldı?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
iu-mcp
İstanbul Üniversitesi'nin akademik takvimini, yemek menüsünü, fakülte duyurularını, ders bilgilerini ve müfredatını yapay zekâ asistanına sorabilmeni sağlayan bir MCP sunucusu. 12 araç içerir. Her yanıtta resmî kaynak bağlantısı ve verinin çekildiği zaman bulunur. Takip ettiğin fakülte ya da dersin duyuru değişikliklerini Telegram'dan bildirim olarak alabilirsin.
Kurulum
Python 3.10+.
git clone https://github.com/haliksuveyt/iu-mcp.git
cd iu-mcp
python -m venv .venv
# Windows
.venv/Scripts/pip install -e .
# macOS / Linux
.venv/bin/pip install -e .MCP istemcinin yapılandırmasına ekle; Python yolunu kendi ortamının tam yoluyla değiştir:
{
"mcpServers": {
"iu-mcp": {
"command": "C:\\yol\\iu-mcp\\.venv\\Scripts\\python.exe",
"args": ["-m", "iu_mcp.server"]
}
}
}macOS/Linux için .venv/bin/python kullan. Codex CLI'da aynı command ve args, [mcp_servers.iu-mcp] TOML bölümüne yazılır.
Related MCP server: Isparta Uni OBS MCP Server
Örnek sorular
“Bugün öğle yemeğinde ne var?” “Bir sonraki sınav dönemi ne zaman?” “Fakültemin son öğrenci duyurularını göster.” “Bu dersin AKTS'si ve haftalık konuları neler?”
Alan | Araçlar |
Akademik yaşam |
|
Fakülte ve dersler |
|
Kişisel takip |
|
9 İÜ fakültesi için fakülte bilgisi sunulur. Ders bilgileri EBS kataloğundan gelir. haftalik_ozet prompt'u haftayı tek yanıtta toplar.
Duyuru takibi
iu-mcp-watch benim-bbtf init --faculty bilgisayar --kind ogrenci --all
iu-mcp-watch benim-bbtf status
iu-mcp-watch benim-bbtf tickİlk tarama başlangıç kaydını oluşturur, sonrakiler değişiklikleri kuyruğa ekler. Zamanlama kaynağı en sık 15 dakikada bir kontrol eder; bildirim teslimi ayrı çalışır. Süreç ortamında IU_MCP_TELEGRAM_BOT_TOKEN ve IU_MCP_TELEGRAM_CHAT_ID ayarlandıktan sonra tick --send ile gönderim açılır.
Aynı anda tek gönderici çalışır, hız sınırı beklemeleri kaydedilir ve sonucu belirsiz kalan teslimler incelemeye alınır. Öğrenci takibi rehberi →
Testler
0.5.0 sürümünde altı canlı resmî kaynak kontrolü dahil 142 test geçti. Testler kaynak güncelliğini, duyuru farkını, SQLite işlemlerini, profil revizyonunu ve Telegram yanıtlarını kapsar.
python -m pip install -e ".[dev]"
python -m pytestVaka incelemesi · Değişiklik takibi · Teslim kuyruğu · Telegram göndericisi
Kaynaklar ve sınırlar
Bağımsız bir öğrenci projesidir, İstanbul Üniversitesi ile resmî bir bağlantısı yoktur. Yalnız herkese açık sayfaları kullanır, öğrenci giriş bilgisi istemez. Akademik kararlar için yanıttaki resmî kaynağa bak. Üniversite verileri ilgili yayıncılarına, proje kodu MIT lisansına tabidir.
Halik Suveyt tarafından geliştirildi. Sorun bildir · Sürümler
Available Tools
12 toolsakademik_takvimA
İÜ önlisans/lisans 2026-2027 akademik takvimi (resmî PDF).
'ozet' alanı güz ve bahar için ders başlangıç/bitiş, final ve bütünleme tarihlerini verir. Ara sınav tarihlerini üniversite değil birimler belirler; takvimde yalnızca ilan için son gün bulunur. Not: takvimde 'bitirme sınavı' = yarıyıl sonu (final) sınavıdır.
Args: sorgu: Etkinlik adında geçen sözcük (örn. "ders ekleme", "bütünleme"). donem: "guz" ya da "bahar"; boşsa ikisi de. kategori: Etkinlik grubuna göre filtre. yaklasan: True ise yalnızca bugünden sonraki tarihler, yakın olandan başlayarak. sinir: En fazla kaç satır döneceği.
Inputs: donem, sinir, sorgu, kategori, +1 more.
bildirim_kuyruguA
listele tüketmeden gösterir; al hazır bildirimleri tek işçiye süreli kiralar.
Okumak teslim edildi sayılmaz. Süresi dolan kiralama belirsiz olur ve kendiliğinden tekrar gönderilmez. al sonucundaki kiralama_anahtari ile bildirim_sonucu çağrılır. Belirsiz kayıtta anahtar inceleme/sonuçlandırma için görünür; aktif kiralamada gizlidir. Bu araç kaynak taramaz, kuyruktaki kalıcı değişiklikleri gösterir.
Inputs: abonelik_id (required), islem, sinir, kiralama_saniye.
bildirim_sonucuA
Gerçek gönderim sonucunu kaydeder; mesaj göndermez ve teslim kanıtı üretmez.
gonderildi yalnız dış gönderici olumlu sonuç verdikten sonra kullanılır. Kesin basarisiz sonucu artan beklemeyle tekrar kuyruğa girer. belirsiz otomatik denenmez; yeniden_dene yalnız gönderilmediği kontrol edildikten sonra seçilir. Yanlış/eski kiralama anahtarı kaydı kapatamaz. Aynı normal sonuç tekrarı güvenlidir.
Inputs: sonuc (required), abonelik_id (required), bildirim_id (required), kiralama_anahtari (required).
ders_bilgisiA
EBS ders izlencesi: kod, AKTS, hoca, amaç, haftalık konular, değerlendirme.
Args: ders: Ders kodu (örn. "CMPE2105") ya da ad parçası (örn. "data structures"). program: Program adı parçası (örn. "yapay zeka"); boşsa Bilgisayar Mühendisliği (İngilizce, örgün öğretim).
Inputs: ders (required), program.
ders_programiA
Fakültenin güncel ders programı: program ve sınıf bazında tablo bağlantıları ile önemli notlar.
Program tabloları fakültenin kendi paylaşımlarıdır; bu araç yalnız bağlantıları ve duyurulan notları (örn. AKSİS yerine web sayfasındaki programa uyulacak dersler) getirir.
Args: fakulte: Boşsa bilgisayar (şu an yalnız BBTF sayfa düzeni desteklenir). program: Süzmek için program adı parçası (örn. "yapay zeka").
Inputs: fakulte, program.
duyuru_aboneligiA
Ders/bölüm filtresiyle yerel takip profili oluşturur; mevcut duyurular başlangıçtır.
Ders kodları tam eşleşir (CMPE3111, CMPE 3111, CMPE-3111). Ders veya bölümden birinin eşleşmesi yeterlidir; önceki/yeni tam metin birlikte kontrol edilir. Filtre olmadan yalnız hepsi=True ile bütün fakülte seçilir. Güncelleme tam profil değişimidir ve güncel beklenen_rev ister; eski bekleyenler iptal edilir. Aktif gönderim kiralaması varken filtre değişmez. Harici mesaj/cron oluşturmaz.
Inputs: abonelik_id (required), tur, bolum, hepsi, +3 more.
duyuru_degisiklikleriA
Son 30 duyurunun yeni görülenlerini ve içerik değişikliklerini yerelde kaydeder.
İlk çağrı başlangıç kaydıdır, eski duyurular değişiklik olarak dönmez. Sonraki çağrı yalnız yeni gözlenen farkları önceki/yeni tam metinleriyle döndürür. Biçim ve boşluk değişiklikleri elenir; bağlantı/ek değişiklikleri korunur. Fakülte ve tür ayrı izlenir. Sayfadan kaybolmak silinme anlamına gelmez. Otomatik arka plan taraması veya bildirim gönderimi yapmaz.
Inputs: tur, fakulte.
duyurular_listesiA
İÜ fakültelerinin duyuru, haber ve etkinlikleri (varsayılan: Bilgisayar ve Bilişim Teknolojileri Fakültesi).
Args: tur: ogrenci (öğrenci duyuruları: ders programı, KZÖ, kulüpler…), duyuru (fakülte duyuruları), haber ya da etkinlik. adet: Kaç kayıt (1-30). ara: Başlık veya özette geçen sözcükle filtrele. fakulte: bilgisayar, iktisat, edebiyat, hukuk, fen, isletme, siyasal, iletisim, mimarlik (ad parçası da olur). Boşsa bilgisayar.
Inputs: ara, tur, adet, fakulte.
fakulte_sayfasiA
Fakülte sitesindeki bilgi sayfaları: staj kuralları, SSS, Erasmus, değişim programları…
Args: konu: Menüde aranacak sözcük (örn. "staj", "erasmus", "sık sorulan"). Boşsa fakültenin tüm sayfa listesi döner; neyin sorulabileceğini görmek için önce bunu kullan. fakulte: bilgisayar, iktisat, edebiyat, hukuk, fen, isletme, siyasal, iletisim, mimarlik. Boşsa bilgisayar.
Inputs: konu, fakulte.
gno_hesaplaA
Harf notlarından dönem ortalaması ve (istenirse) yeni genel not ortalaması. Çevrimdışı çalışır.
Ortalama AKTS ağırlıklıdır. Varsayılan ölçek 4'lük yaygın tablodur (AA 4.0 … FF 0); kendi
yönetmeliğindeki katsayılar farklıysa olcek ile ver. Resmî hesap için OBS/transkript geçerlidir.
Args: dersler: [{"ad": "Veri Yapıları", "akts": 6, "not": "BB"}, ...] onceki_akts: Bu dönemden önce tamamlanan toplam AKTS. onceki_gno: Bu dönemden önceki genel not ortalaması. olcek: Örn. {"AA": 4, "BA": 3.5, ...}.
Inputs: dersler (required), olcek, onceki_gno, onceki_akts.
mufredatA
Bir programın 2026-27 müfredatı: hangi sınıfta hangi dersler, kaç AKTS.
Args: sinif: 1-4; boşsa hepsi. yariyil: "Güz" ya da "Bahar"; boşsa ikisi de. program: Program adı parçası; boşsa Bilgisayar Mühendisliği (İngilizce).
Inputs: sinif, program, yariyil.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 12 tools
The tools map to mostly distinct resources: cafeteria menu, course syllabus, announcements, schedule links, calendar, faculty pages, GPA, curriculum, and notification queue handling. Mild overlap exists among ders_bilgisi/ders_programi/mufredat and among duyurular_listesi/duyuru_degisiklikleri/duyuru_aboneligi, but the descriptions and argument shapes make the boundaries clear enough.
Twelve tools use consistent snake_case Turkish naming, mostly noun phrases describing the resource (yemekhane_menusu, ders_bilgisi, akademik_takvim). The one action-style name gno_hesapla is a minor deviation from the otherwise resource-oriented pattern, but still readable and predictable.
At 12 tools the surface is well-scoped for a university student information server. Each tool corresponds to a concrete need or tightly coupled workflow (announcement subscription plus notification queue/result), with little sign of bloat.
The surface covers cafeteria menus, course syllabus/schedule/curriculum, announcements and subscriptions, academic calendar, faculty pages, GPA calculation, and notification delivery state. Minor gaps remain, such as a direct exam-schedule lookup or OBS/transcript integration, but these are partially addressable through the calendar and course tools.
Maintenance
Related MCP Connectors
Track calories and macros right in Claude or ChatGPT and build a personal nutrition diary
111Import a term from syllabi into Helium, a free student planner, and ask about what's due and grades.
Calorie, workout and body-weight log inside ChatGPT and Claude. Log meals by text, photo or voice.
Search university course materials, your flashcards, quizzes, streak and quota. All tools read-only.
Related MCP Servers
- FlicenseAqualityDmaintenanceEnables natural language queries about grades, GPA, attendance, and schedules by connecting Claude to StudentVue school dashboards. Includes analytical tools for grade simulation, what-if scenarios, and academic performance tracking based on live school data.19-
- FlicenseNot gradedqualityDmaintenanceEnables students to securely access and manage their academic data from Isparta University's OBS system, including grades, transcripts, announcements, and course information through natural language queries.1-
- AlicenseBqualityBmaintenanceUnofficial local MCP server for Istanbul Technical University (İTÜ) students. Reads your own Ninova LMS, OBS and Portal data with your own account: assignments and deadlines, grades and cumulative GPA simulation, schedule and exams, registration, course archive, library and campus services. Read-only by default; the two write tools ask for confirmation.108202 PyPI17MIT
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to query METU's ODTUClass LMS for enrolled courses, announcements, syllabi, assignment deadlines, and lab/recitation schedules using credential or token authentication.1GPL 2.0