İTÜ MCP

İTÜ Ninova LMS ve OBS öğrenci portalı — dersler, notlar, yoklama, yemekhane, kampüs kart, GPA

Quick Install

Automated & IDE Setup

Copy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.

Add to Cursor Add to VS Code

Manual Client & Custom JSON ConfigExpand JSON ▾

Client Config & Setup

Choose your client or environment

Target File:~/Library/Application Support/Claude/claude_desktop_config.json

claude_desktop_config.json

{
  "mcpServers": {
    "i-t-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "i-t-mcp"
      ]
    }
  }
}

💡 Paste the JSON block into your client's configuration file under mcpServers, then restart the application.

Documentation Overview

İTÜ MCP

İTÜ Ninova, OBS, Portal, kampüs servisleri ve kütüphaneyi Claude, Cursor, Codex ve diğer MCP istemcilerine bağla

İTÜ MCP nedir?

Ninova'da ödev, OBS'de not, Portal'da yemek listesi diye üç ayrı sekmede gezinmek can sıkıcı. İTÜ MCP bilgisayarında çalışan küçük bir sunucu, bu sekmelerin hepsini tek bir yerden, doğal dilde sorulabilir hale getiriyor.

Kimlik bilgilerinle (genelde ad@itu.edu.tr) Ninova, OBS ve Portal verilerini okuyor. Kimlik bilgisi olmadan da ders/final programı, bina kodları, mekik, spor tesisi, duyuru ve kütüphane kataloğu gibi herkese açık kaynaklara erişiyor. Sonuçları Model Context Protocol üzerinden yapılandırılmış araçlar olarak sunuyor: Claude'a soruyorsun, o da gerçek veriyi çekip cevap veriyor.

İhtiyacın	İTÜ MCP cevabı
"Bu hafta hangi ödevlerin teslimi var?"	Ninova ödev ve teslim tarihi araçları
"X dersinin notları / yoklaması?"	OBS ara not, harf notu ve yoklama
"Transkript / danışman / staj?"	OBS profil, danışman, staj, transkript PDF
"Bugün yemekte ne var / kart bakiyem?"	İTÜ Portal menü, kart ve bildirim araçları
"Finalim ne zaman / boş kontenjan var mı?"	Public OBS final ve ders programı araçları
"Mekik ne zaman / havuz kaçta kapanıyor?"	SKS kampüs hizmeti araçları
"Kütüphanede bu kitap var mı?"	Public katalog arama ve kopya durumu
"Son okunmamış mailimi göster"	Salt okunur İTÜ Mail araçları
"PDF özetle"	İndirme ve `read_resource_text` (PDF/DOCX)
"Ödev yükle"	İsteğe bağlı yükleme, `confirm=true` şart

Önce yerel. Ninova şifren cihazda kalır, yalnızca İTÜ SSO, Ninova, OBS ve Portal akışlarında kullanılır. Ayrı kütüphane hesabı bilgileri yalnızca resmî kütüphane sunucusuna gönderilir. Üçüncü taraf bir sunucuya kimlik bilgisi depolanmaz.

İTÜ ile resmi bağlantısı yoktur. Yalnızca kendi hesabınla kullan.

Dürüst olmak gerekirse OBS'nin bazı uç noktaları hesaba göre tutarsız davranabiliyor, bir hesapta not alanı boş dönerken başka bir hesapta doluyor gibi. Böyle durumları elimizden geldiğince yakalayıp yedek kaynağa düşüyoruz ve sonucu açıkça işaretliyoruz, ama tam garanti veremeyiz. Şüpheye düştüğünde her zaman OBS'nin kendi sayfasına bak.

Nasıl çalışır

mermaid

graph LR
    istemci["Claude, Cursor, Codex"] -->|"MCP"| sunucu["İTÜ MCP"]
    sunucu --> ninova["Ninova"]
    sunucu --> obs["OBS"]
    sunucu --> portal["Portal"]
    sunucu --> kutuphane["Kütüphane"]
    sunucu --> arsiv["Ders Arşivi"]
    sunucu --> mail["İTÜ Mail"]

Sunucu her servise ayrı bir istemci sınıfıyla konuşur, kendi oturumunu ve önbelleğini yönetir. Ninova ve OBS aynı İTÜ SSO girişini paylaşır, kütüphane hesabı bilgisi ise tamamen ayrıdır ve Ninova şifresiyle karışmaz. Kimlik gerektirmeyen araçlar (public ders programı, kampüs servisleri, arşiv) hiçbir zaman şifreni kullanmaz.

Ayrıntılı iç mimari ve istemci sınıfları için: docs/advanced.md.

Örnekler

itu-mcp CLI demo
CLI: --version, --list-tools, --list-prompts (gerçek çıktı)

Claude Desktop üzerinden doğal dilde soru sorma örnekleri:

Bu dönem hangi dersleri aldım
OBS: dönem kayıtlı dersler ve program

Son duyurular ve mesajlar
Ninova: son duyurular ve mesaj panosu özeti

Hızlı başlangıç

1. Kurulum

bash

pipx install itu-mcp
# veya: pip install --user itu-mcp
# kaynaktan:
#   git clone https://github.com/yatuk/itu-mcp.git
#   cd itu-mcp && pip install -e .

2. Kimlik bilgileri

bash

cp .env.example .env
# NINOVA_USERNAME=ad.soyad@itu.edu.tr
# NINOVA_PASSWORD=********

Kullanıcı adı genelde İTÜ e-posta adresidir, yalnızca yerel kısım değil.

3. Duman testi

bash

itu-mcp --version
itu-mcp --check-auth
itu-mcp --list-tools
itu-mcp --list-prompts

4. MCP istemcisini bağla

Claude Code

Terminal

claude mcp add itu itu-mcp \
  -e NINOVA_USERNAME=ad.soyad@itu.edu.tr \
  -e NINOVA_PASSWORD=sifren

Codex CLI

bash

codex mcp add itu \
  --env NINOVA_USERNAME=ad.soyad@itu.edu.tr \
  --env NINOVA_PASSWORD=sifren \
  -- itu-mcp

Claude Desktop / Cursor: docs/installation.md ve examples/ klasörüne bak.

Bu kadar. İstemciyi yeniden başlat ve sor: "Ninova'daki derslerimi listele" veya "OBS'te bu dönem kayıtlı derslerim?"

Ne sorabilirsin?

"Bu hafta hangi ödevlerimin teslimi var?"
"EEF 211E sınıf dosyalarındaki PDF'i oku."
"OBS'te 2025-2026 Bahar kayıtlı derslerim neler?"
"CEN 354E ara notlarım?"
"Danışmanım kim? Staj bilgilerimi göster."
"Transkript PDF indir."
"Son okunmamış mesajlarımı listele ve seçtiğim PDF ekini özetle."
"Gelecek dönem hangi dersleri almalıyım?"^✨
"Vizeden 63 aldım, sınıf 30,35,40...90 arası dağılmış, hangi harf notunu alırım?"^✨
"BLG bölümünde bu dönem hangi dersler açılmış, kontenjan durumu ne?"^✨
"BLG 223E'yi almak için önce hangi dersleri almam lazım?"^✨
"BBB binası neresi, bugün 10:00'da hangi derslikler boş görünüyor?"^✨
"İTÜ mekik saatleri ve yüzme havuzu çalışma saatleri?"^✨
"Kütüphanede Introduction to Algorithms var mı?"^✨

^✨ _{Kimlik gerektirmez, .env olmadan da çalışır.}

Araç haritası

Ninova _{oturum gerekir}	OBS & Portal _{oturum gerekir}	Public İTÜ _{kimlik gerekmez ✨}	Planlama & Kütüphane _karma	Arşiv _{kimlik gerekmez ✨}
`auth_status` · `list_courses` `get_course_*` · `sync_all_courses` `get_upcoming_deadlines` `read_resource_text` · `submit_assignment`	`obs_auth_status` · `obs_get_profile` `obs_list_registered_courses` `obs_get_course_grades` · `obs_get_attendance` `obs_get_advisor` · `obs_download_transcript` `get_cafeteria_menu` · `obs_get_notifications`	`get_public_course_schedule` · `get_public_exam_schedule` `search_itu_directory` · `search_campus_locations` `get_shuttle_schedule` · `get_sports_facility_hours` `get_itu_announcements` · `get_academic_calendar`	`obs_calculate_gpa` · `calculate_target_gpa` `estimate_relative_grade` · `check_course_conflicts` `find_open_course_sections` · `find_empty_classrooms` `build_degree_plan` · `library_*`	`archive_who_taught` · `archive_course_history` `archive_fill_rate` · `archive_term_sections` `archive_search_courses` · `plan_remaining_courses`
İTÜ Mail (salt okunur): `mail_status` · `mail_list_inbox` · `mail_get_message` · `mail_get_attachment`

Tam araç listesi, hazır prompt'lar, kaynak tabloları, Docker, uzak HTTP ve tüm ortam değişkenleri: docs/advanced.md.

Ayrıca / menüsünden seçilebilen hazır akışlar var (weekly_briefing, plan_next_term, check_course_eligibility, research_course, gpa_scenario), her biri hangi araçların hangi sırayla çağrılacağını ve sonucu okurken kaçırılan kuralları içeriyor.

Güvenlik

Kendi hesabını kullanıyorsun, o yüzden şuna dikkat et:

Read the full README →View source on GitHub →

Related MCP Servers

View all in Developer Tools View all alternatives

Reviews

No reviews yet — be the first to share how this listing worked for you.

Frequently Asked Questions about İTÜ MCP

Add the following block to your claude_desktop_config.json under mcpServers: "mcpServers": { "i-t-mcp": { "command": "npx", "args": ["-y", "İTÜ MCP"] } }

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:

Live Dynamic SVG Preview

Markdown (GitHub README)

[![AllMCPs](https://allmcps.com/api/badge/i-t-mcp?style=directory)](https://allmcps.com/mcp/i-t-mcp)

HTML Embed

<a href="https://allmcps.com/mcp/i-t-mcp"><img src="https://allmcps.com/api/badge/i-t-mcp?style=directory" alt="İTÜ MCP on AllMCPs" /></a>

Technical Specs & Signals

CategoryDeveloper Tools

27Quality signal: Emerging · 27/100How this signal is calculated ▾

Server availabilityNot measured

Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.

Verified ownership8/20

Documentation & tools11/30

Adoption & activity1/15

Community engagement0/10

A guidance signal from public completeness & health data — not a user rating. New listings start lower and rise as they add docs, get verified, and grow adoption. Signals we can't observe for a listing are skipped, not counted against it.

★ Featured

AllMCPs Server

The official MCP server for AllMCPs.com - submit and manage tools directly from your AI. The open directory for MCP servers. Connect Claude, Cursor, Windsurf, and AI agents to databases, tools, files, and APIs. Explore 10,000+ servers. AllMCPs is the premier, open directory for discovering, evaluating, and installing Model Context Protocol (MCP) servers to equip AI agents and LLMs with real-world superpowers.

Explore Server →

Own this project?

This directory is pre-filled from public sources. Claim via GitHub README, site badge, or DNS TXT to unlock edit access and the Official badge and attach your website — proof is checked automatically, then reviewed by our team.

Free dofollow backlink: add your website and place the AllMCPs badge on it — no claim needed. We detect it automatically and keep it verified as long as the badge stays live.

Claim & get free dofollow

Share & Embed

Add our SVG badge (dark/light directory styles) or embeddable widget to your site.

Explore more

More in 💻 Developer Tools →Best MCP servers for Developers →Alternatives to İTÜ MCP →Install in Claude Desktop Install in Cursor Install in VS Code

İTÜ MCP

İTÜ Ninova LMS ve OBS öğrenci portalı — dersler, notlar, yoklama, yemekhane, kampüs kart, GPA

Quick Install

Automated & IDE Setup

Copy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.

Add to Cursor Add to VS Code

Manual Client & Custom JSON ConfigExpand JSON ▾

Client Config & Setup

Choose your client or environment

Target File:~/Library/Application Support/Claude/claude_desktop_config.json

claude_desktop_config.json

{
  "mcpServers": {
    "i-t-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "i-t-mcp"
      ]
    }
  }
}

💡 Paste the JSON block into your client's configuration file under mcpServers, then restart the application.

Documentation Overview

İTÜ MCP

İTÜ Ninova, OBS, Portal, kampüs servisleri ve kütüphaneyi Claude, Cursor, Codex ve diğer MCP istemcilerine bağla

İTÜ MCP nedir?

İhtiyacın	İTÜ MCP cevabı
"Bu hafta hangi ödevlerin teslimi var?"	Ninova ödev ve teslim tarihi araçları
"X dersinin notları / yoklaması?"	OBS ara not, harf notu ve yoklama
"Transkript / danışman / staj?"	OBS profil, danışman, staj, transkript PDF
"Bugün yemekte ne var / kart bakiyem?"	İTÜ Portal menü, kart ve bildirim araçları
"Finalim ne zaman / boş kontenjan var mı?"	Public OBS final ve ders programı araçları
"Mekik ne zaman / havuz kaçta kapanıyor?"	SKS kampüs hizmeti araçları
"Kütüphanede bu kitap var mı?"	Public katalog arama ve kopya durumu
"Son okunmamış mailimi göster"	Salt okunur İTÜ Mail araçları
"PDF özetle"	İndirme ve `read_resource_text` (PDF/DOCX)
"Ödev yükle"	İsteğe bağlı yükleme, `confirm=true` şart

Önce yerel. Ninova şifren cihazda kalır, yalnızca İTÜ SSO, Ninova, OBS ve Portal akışlarında kullanılır. Ayrı kütüphane hesabı bilgileri yalnızca resmî kütüphane sunucusuna gönderilir. Üçüncü taraf bir sunucuya kimlik bilgisi depolanmaz.

İTÜ ile resmi bağlantısı yoktur. Yalnızca kendi hesabınla kullan.

Nasıl çalışır

mermaid

graph LR
    istemci["Claude, Cursor, Codex"] -->|"MCP"| sunucu["İTÜ MCP"]
    sunucu --> ninova["Ninova"]
    sunucu --> obs["OBS"]
    sunucu --> portal["Portal"]
    sunucu --> kutuphane["Kütüphane"]
    sunucu --> arsiv["Ders Arşivi"]
    sunucu --> mail["İTÜ Mail"]

Ayrıntılı iç mimari ve istemci sınıfları için: docs/advanced.md.

Örnekler

itu-mcp CLI demo
CLI: --version, --list-tools, --list-prompts (gerçek çıktı)

Claude Desktop üzerinden doğal dilde soru sorma örnekleri:

Bu dönem hangi dersleri aldım
OBS: dönem kayıtlı dersler ve program

Son duyurular ve mesajlar
Ninova: son duyurular ve mesaj panosu özeti

Hızlı başlangıç

1. Kurulum

bash

pipx install itu-mcp
# veya: pip install --user itu-mcp
# kaynaktan:
#   git clone https://github.com/yatuk/itu-mcp.git
#   cd itu-mcp && pip install -e .

2. Kimlik bilgileri

bash

cp .env.example .env
# NINOVA_USERNAME=ad.soyad@itu.edu.tr
# NINOVA_PASSWORD=********

Kullanıcı adı genelde İTÜ e-posta adresidir, yalnızca yerel kısım değil.

3. Duman testi

bash

itu-mcp --version
itu-mcp --check-auth
itu-mcp --list-tools
itu-mcp --list-prompts

4. MCP istemcisini bağla

Claude Code

Terminal

claude mcp add itu itu-mcp \
  -e NINOVA_USERNAME=ad.soyad@itu.edu.tr \
  -e NINOVA_PASSWORD=sifren

Codex CLI

bash

codex mcp add itu \
  --env NINOVA_USERNAME=ad.soyad@itu.edu.tr \
  --env NINOVA_PASSWORD=sifren \
  -- itu-mcp

Claude Desktop / Cursor: docs/installation.md ve examples/ klasörüne bak.

Bu kadar. İstemciyi yeniden başlat ve sor: "Ninova'daki derslerimi listele" veya "OBS'te bu dönem kayıtlı derslerim?"

Ne sorabilirsin?

"Bu hafta hangi ödevlerimin teslimi var?"
"EEF 211E sınıf dosyalarındaki PDF'i oku."
"OBS'te 2025-2026 Bahar kayıtlı derslerim neler?"
"CEN 354E ara notlarım?"
"Danışmanım kim? Staj bilgilerimi göster."
"Transkript PDF indir."
"Son okunmamış mesajlarımı listele ve seçtiğim PDF ekini özetle."
"Gelecek dönem hangi dersleri almalıyım?"^✨
"Vizeden 63 aldım, sınıf 30,35,40...90 arası dağılmış, hangi harf notunu alırım?"^✨
"BLG bölümünde bu dönem hangi dersler açılmış, kontenjan durumu ne?"^✨
"BLG 223E'yi almak için önce hangi dersleri almam lazım?"^✨
"BBB binası neresi, bugün 10:00'da hangi derslikler boş görünüyor?"^✨
"İTÜ mekik saatleri ve yüzme havuzu çalışma saatleri?"^✨
"Kütüphanede Introduction to Algorithms var mı?"^✨

^✨ _{Kimlik gerektirmez, .env olmadan da çalışır.}

Araç haritası

Ninova _{oturum gerekir}	OBS & Portal _{oturum gerekir}	Public İTÜ _{kimlik gerekmez ✨}	Planlama & Kütüphane _karma	Arşiv _{kimlik gerekmez ✨}
`auth_status` · `list_courses` `get_course_*` · `sync_all_courses` `get_upcoming_deadlines` `read_resource_text` · `submit_assignment`	`obs_auth_status` · `obs_get_profile` `obs_list_registered_courses` `obs_get_course_grades` · `obs_get_attendance` `obs_get_advisor` · `obs_download_transcript` `get_cafeteria_menu` · `obs_get_notifications`	`get_public_course_schedule` · `get_public_exam_schedule` `search_itu_directory` · `search_campus_locations` `get_shuttle_schedule` · `get_sports_facility_hours` `get_itu_announcements` · `get_academic_calendar`	`obs_calculate_gpa` · `calculate_target_gpa` `estimate_relative_grade` · `check_course_conflicts` `find_open_course_sections` · `find_empty_classrooms` `build_degree_plan` · `library_*`	`archive_who_taught` · `archive_course_history` `archive_fill_rate` · `archive_term_sections` `archive_search_courses` · `plan_remaining_courses`
İTÜ Mail (salt okunur): `mail_status` · `mail_list_inbox` · `mail_get_message` · `mail_get_attachment`

Tam araç listesi, hazır prompt'lar, kaynak tabloları, Docker, uzak HTTP ve tüm ortam değişkenleri: docs/advanced.md.

Güvenlik

Kendi hesabını kullanıyorsun, o yüzden şuna dikkat et:

Read the full README →View source on GitHub →

Related MCP Servers

View all in Developer Tools View all alternatives

Reviews

No reviews yet — be the first to share how this listing worked for you.

Frequently Asked Questions about İTÜ MCP

Add the following block to your claude_desktop_config.json under mcpServers: "mcpServers": { "i-t-mcp": { "command": "npx", "args": ["-y", "İTÜ MCP"] } }

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:

Live Dynamic SVG Preview

Markdown (GitHub README)

[![AllMCPs](https://allmcps.com/api/badge/i-t-mcp?style=directory)](https://allmcps.com/mcp/i-t-mcp)

HTML Embed

<a href="https://allmcps.com/mcp/i-t-mcp"><img src="https://allmcps.com/api/badge/i-t-mcp?style=directory" alt="İTÜ MCP on AllMCPs" /></a>

Technical Specs & Signals

CategoryDeveloper Tools

27Quality signal: Emerging · 27/100How this signal is calculated ▾

Server availabilityNot measured

Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.

Verified ownership8/20

Documentation & tools11/30

Adoption & activity1/15

Community engagement0/10

★ Featured

AllMCPs Server

Explore Server →

Own this project?

Free dofollow backlink: add your website and place the AllMCPs badge on it — no claim needed. We detect it automatically and keep it verified as long as the badge stays live.

Claim & get free dofollow

Share & Embed

Add our SVG badge (dark/light directory styles) or embeddable widget to your site.

Explore more

More in 💻 Developer Tools →Best MCP servers for Developers →Alternatives to İTÜ MCP →Install in Claude Desktop Install in Cursor Install in VS Code