iu-mcp
<p align="center"><img src="docs/img/hero.svg" alt="iu-mcp — Üniversiten, asistanına bağlı" width="100%"></p>
<p align="center"><strong>Türkçe</strong> · <a href="README.en.md">English</a></p>
<p align="center"><a href="https://github.com/haliksuveyt/iu-mcp/actions/workflows/test.yml"><img src="https://github.com/haliksuveyt/iu-mcp/actions/workflows/test.yml/badge.svg" alt="CI"></a> <a href="https://github.com/haliksuveyt/iu-mcp/releases/latest"><img src="https://img.shields.io/github/v/release/haliksuveyt/iu-mcp?color=8172c2" alt="Release"></a> <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-64748b" alt="MIT license"></a></p>
# 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+**.
```bash
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:
```json
{
"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.
## Örnek sorular
> “Bugün öğle yemeğinde ne var?”<br>
> “Bir sonraki sınav dönemi ne zaman?”<br>
> “Fakültemin son öğrenci duyurularını göster.”<br>
> “Bu dersin AKTS'si ve haftalık konuları neler?”
<img src="docs/img/workflow.svg" alt="Resmî kaynaktan yapılandırılmış veriye, değişiklik takibine ve asistana" width="100%">
| 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
```bash
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 →](docs/ogrenci-takibi.md)
## 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.
```bash
python -m pip install -e ".[dev]"
python -m pytest
```
[Vaka incelemesi](docs/vaka-incelemesi.md) · [Değişiklik takibi](docs/degisiklik-takibi.md) · [Teslim kuyruğu](docs/bildirim-kuyrugu.md) · [Telegram göndericisi](docs/telegram-gonderici.md)
## 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](LICENSE) tabidir.
[Halik Suveyt](https://github.com/haliksuveyt) tarafından geliştirildi. [Sorun bildir](https://github.com/haliksuveyt/iu-mcp/issues) · [Sürümler](https://github.com/haliksuveyt/iu-mcp/releases)
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.