Skip to main content
Glama

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

akademik_takvim, yemekhane_menusu, gno_hesapla

Fakülte ve dersler

duyurular_listesi, ders_programi, fakulte_sayfasi, ders_bilgisi, mufredat

Kişisel takip

duyuru_degisiklikleri, duyuru_aboneligi, bildirim_kuyrugu, bildirim_sonucu

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 pytest

Vaka 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 tools
akademik_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.

yemekhane_menusuB

İÜ SKS öğrenci yemekhanesi menüsü (sks.istanbul.edu.tr).

Args: gun: "bugun", "yarin" ya da YYYY-MM-DD. gun_sayisi: Başlangıç gününden itibaren kaç gün (1-7). ogun: kahvalti, ogle, aksam, vegan ya da hepsi.

Inputs: gun, ogun, gun_sayisi.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.9/5.0

    Scored across 12 tools

    Disambiguation4/5

    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.

    Naming Consistency4/5

    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.

    Tool Count5/5

    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.

    Completeness4/5

    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

    ActivityNo data
    ResponsivenessSyncing

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      A
      quality
      D
      maintenance
      Enables 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
      -
    • F
      license
      Not graded
      quality
      D
      maintenance
      Enables 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
      -
    • A
      license
      B
      quality
      B
      maintenance
      Unofficial 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.
      108
      202 PyPI
      17
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables AI assistants to query METU's ODTUClass LMS for enrolled courses, announcements, syllabi, assignment deadlines, and lab/recitation schedules using credential or token authentication.
      1
      GPL 2.0