İTÜ MCP

Name: İTÜ MCP
Author: yatuk

de yatukversión 1.4.0i★ –iSe ejecuta en tu computadora

Nombre en el registroio.github.yatuk/itu-mcp

Instalar

Resumen

Descripción del creador (original en inglés)

İTÜ Ninova, OBS, Portal, kampüs servisleri ve kütüphane için MCP sunucusu

Los tres pilares de PopNx MCP

Estos tres nunca se combinan en una sola puntuación: las opiniones, las mediciones y la popularidad son cosas distintas.

Opinión de usuariosiAún no hay reseñasLas reseñas se abrirán junto con las cuentas en una etapa posterior
Nuestras revisiones básicasi1 de 1 superadasRevisado con información pública; el código aún no se ha escaneado
UsoiMuy nuevo↓ 62/sem · ★ –

Qué puedes hacer con él

Todavía no escribimos un resumen sencillo para este. Abajo están los datos que leímos del registro.

Conexión: Se ejecuta en tu computadora
Transporte: stdio
Categoría: Otros
Debes completar: NINOVA_PASSWORD, NINOVA_MAIL_PASSWORD, NINOVA_LIBRARY_ID, NINOVA_LIBRARY_PIN

Instalación

Elige la app de IA que usas y copia la configuración.

Antes de instalar

Revisiones básicas: 1 de 1 superadas
Se ejecuta en tu computadora con los permisos de tu usuario (archivos, red, apps).
Debes completar tú: NINOVA_USERNAME, NINOVA_PASSWORD, NINOVA_MAIL_USERNAME, NINOVA_MAIL_PASSWORD, NINOVA_LIBRARY_NAME, NINOVA_LIBRARY_ID, NINOVA_LIBRARY_PIN

Los valores marcados como secretos son llaves de tu cuenta. Nunca los compartas ni los pegues en un chat.

Necesitas

PyPIuv de Python instalado (para el comando uvx)

¿Qué app usas?

ClaudeClaude CodeCursorVS CodeChatGPT

Elige tu app arriba. La recordamos, así que la próxima vez el botón dirá “Instalar en …”.

Abre Claude Desktop → Settings → Developer → Edit Config y pega esto en claude_desktop_config.json

{
  "mcpServers": {
    "itu": {
      "command": "uvx",
      "args": [
        "itu-mcp"
      ],
      "env": {
        "NINOVA_USERNAME": "your-value",
        "NINOVA_PASSWORD": "your-value",
        "NINOVA_MAIL_USERNAME": "your-value",
        "NINOVA_MAIL_PASSWORD": "your-value",
        "NINOVA_LIBRARY_NAME": "your-value",
        "NINOVA_LIBRARY_ID": "your-value",
        "NINOVA_LIBRARY_PIN": "your-value"
      }
    }
  }
}

Ejecuta esto en tu terminal

claude mcp add itu --env NINOVA_USERNAME=your-value --env NINOVA_PASSWORD=your-value --env NINOVA_MAIL_USERNAME=your-value --env NINOVA_MAIL_PASSWORD=your-value --env NINOVA_LIBRARY_NAME=your-value --env NINOVA_LIBRARY_ID=your-value --env NINOVA_LIBRARY_PIN=your-value -- uvx itu-mcp

Completa los valores vacíos antes de ejecutarlo.

Abrir en Cursor

O copia la configuración tú

Pégalo en .cursor/mcp.json de tu proyecto, o en ~/.cursor/mcp.json

{
  "mcpServers": {
    "itu": {
      "command": "uvx",
      "args": [
        "itu-mcp"
      ],
      "env": {
        "NINOVA_USERNAME": "your-value",
        "NINOVA_PASSWORD": "your-value",
        "NINOVA_MAIL_USERNAME": "your-value",
        "NINOVA_MAIL_PASSWORD": "your-value",
        "NINOVA_LIBRARY_NAME": "your-value",
        "NINOVA_LIBRARY_ID": "your-value",
        "NINOVA_LIBRARY_PIN": "your-value"
      }
    }
  }
}

Tu navegador te pide permiso para abrir la app; luego la app muestra la configuración y te pide confirmar. Los valores de las claves quedan vacíos para que los completes tú.

Abrir en VS Code

O copia la configuración tú

Pégalo en .vscode/mcp.json de tu proyecto

{
  "servers": {
    "itu": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "itu-mcp"
      ],
      "env": {
        "NINOVA_USERNAME": "your-value",
        "NINOVA_PASSWORD": "your-value",
        "NINOVA_MAIL_USERNAME": "your-value",
        "NINOVA_MAIL_PASSWORD": "your-value",
        "NINOVA_LIBRARY_NAME": "your-value",
        "NINOVA_LIBRARY_ID": "your-value",
        "NINOVA_LIBRARY_PIN": "your-value"
      }
    }
  }
}

Tu navegador te pide permiso para abrir la app; luego la app muestra la configuración y te pide confirmar. Los valores de las claves quedan vacíos para que los completes tú.

Este se ejecuta en tu computadora, y ChatGPT solo puede conectarse a servidores en internet. Elige otra app.

Tu elección se guarda en una cookie en este dispositivo; no necesitas cuenta.

Valores que debes completar

NINOVA_USERNAME env
İTÜ e-posta adresi (ad.soyad@itu.edu.tr)
NINOVA_PASSWORD secreto env
İTÜ şifresi
NINOVA_MAIL_USERNAME env
Optional separate ITU Mail username
NINOVA_MAIL_PASSWORD secreto env
Optional separate ITU Mail password
NINOVA_LIBRARY_NAME env
Kütüphane hesabındaki ad (hesap araçları için isteğe bağlı)
NINOVA_LIBRARY_ID secreto env
Kütüphane üniversite numarası (hesap araçları için isteğe bağlı)
NINOVA_LIBRARY_PIN secreto env
Ayrı kütüphane PIN'i (hesap araçları için isteğe bağlı)

Esta configuración se genera a partir de la ficha del creador en el registro. Si el README dice otra cosa, sigue el README.

Qué puede hacer

Se ejecuta en tu computadora; la lista de herramientas aparece en tu app de IA después de instalarlo.

Revisiones básicasi

Revisamos información que cualquiera puede ver; no hemos leído el código. Las revisiones que no aplican no se cuentan. · Revisado el 9 nov 2026

✓ Superada
El creador coincide con el repo
El nombre en el registro se verificó con la cuenta de GitHub yatuk, dueña del repo
… Aún sin revisar
Sigue en mantenimiento
Todavía no hemos leído este repo en GitHub
… Aún sin revisar
Tiene licencia
Todavía no hemos leído este repo en GitHub
– No aplica
El endpoint responde
Este se ejecuta en tu computadora; no hay endpoint en internet
– No aplica
Inicio de sesión con OAuth
Se ejecuta en tu computadora y usa ajustes locales en su lugar
… Aún sin revisar
Sin instrucciones ocultas en las descripciones de herramientas
Se ejecuta en tu computadora; solo podemos leer listas de herramientas de endpoints en internet

Comparado con otros en Otrosi

Más estrellas que el 0% de los otros 18643 servidores de esta categoría
Publicado en el registro más recientemente que el 76% de los otros 18643 servidores de esta categoría
Revisiones básicas iguales o mejores que el 100% de los otros 18643 servidores de esta categoría

Comparado con todos los servidores activos de esta categoría en el registro. Las estrellas solo cuentan cuando quien lo publica es dueño del repo.

Preguntas frecuentes

¿Es seguro İTÜ MCP?

Superó 1 de 1 revisiones básicas aplicables. No hemos leído el código. Antes de agregar una clave o un token, revisa qué acceso pide el servidor y usa una clave que tenga solo los permisos que necesitas.

¿Qué claves o códigos necesita?

Debes completar: NINOVA_PASSWORD, NINOVA_MAIL_PASSWORD, NINOVA_LIBRARY_ID, NINOVA_LIBRARY_PIN

¿Se ejecuta en mi computadora o en la nube?

Se ejecuta en tu computadora. Tu app de IA lo inicia cuando hace falta, y los datos no pasan por los servidores del creador (a menos que el propio servidor llame a un servicio en línea).

¿Sigue en mantenimiento?

El repo de GitHub cambió por última vez –, y la última versión (1.4.0) llegó al registro hace 12 días.

¿Qué apps pueden usarlo?

Las apps compatibles con MCP, como Claude Desktop, Claude Code, Cursor y VS Code. También necesitas Python (uv) en tu computadora.

¿Qué puedo usar en su lugar?

En la misma categoría: Spec Driven Development, Remote Desktop Commander, Cosas Guapas: buscador de regalos

Alternativas

Servidores de la misma categoría hechos por otros creadores, ordenados por estrellas.

Cómo leer una tarjeta:↓ Descargas por semanai★ Estrellas de GitHubiTres pilares: reseñas · revisiones · usoiActualizado = fecha en que se publicó la última versión en el registroi

Spec Driven Development

MCP Server that facilitates spec-driven development workflows, not just Vibe Coding.

de formulahendryInicial↓ 66/sem★ 440Actualizado hace 14 meses

Se ejecuta en tu computadora

Instalar

Remote Desktop Commander

Remote Desktop Commander: use files, terminal and processes on your own computers from any AI app.

de desktop-commanderEn crecimiento★ 211Actualizado hace 3 días

Se ejecuta en la nube✓ desktopcommander.app

Instalar

Cosas Guapas: buscador de regalos

Regalos originales por ocasión, persona y presupuesto, con enlaces a guías completas (España).

de cosasguapas.comInicialActualizado hoy

Se ejecuta en la nube✓ cosasguapas.com

Instalar

README del creador

Abrir el README

Copiado tal cual del repo del creador. PopNx MCP no lo ha revisado ni lo respalda. Se quitaron HTML, imágenes y scripts. Los enlaces llevan fuera de este sitio.

İTÜ MCP

Ninova, OBS, Portal, kütüphane ve ders arşivini yapay zeka asistanına bağla. Sonra sadece sor.

Kur · Örnekler · Sık sorulanlar · Tüm araçlar

Sesli ve tam çözünürlüklü hali: docs/demo.mp4

In English

İTÜ MCP is an unofficial, open source Model Context Protocol server for students of Istanbul Technical University (İTÜ). It runs on your own computer and lets an AI assistant such as Claude, ChatGPT, Cursor or Codex read İTÜ's systems for you: the Ninova LMS (courses, assignments, files, announcements), İTÜ Moodle and the physics, chemistry and math pool course sites (syllabi, guides, announcements), OBS (grades, schedule, registration status, transcript, graduation progress), the student Portal, the library catalog and a public archive of past course offerings.

Ask in plain language: "what is due this week", "what will my GPA be if I get BB in everything", "which sections of MAT 210E still have seats".
Read-only by default. The two actions that change something (uploading an assignment, saving a registration draft) ask you for confirmation first.
Your İTÜ password stays on your machine and is sent only to İTÜ's own login page.
Install with pipx install itu-mcp, or add it to Claude Code as a plugin: claude plugin marketplace add yatuk/itu-mcp.

The rest of this page is in Turkish. Setup: 3 adımda kur. Full tool list: docs/advanced.md. Security model: docs/security.md. This project is not affiliated with İTÜ.

Bu ne işe yarıyor?

Ödev için Ninova'ya, not için OBS'ye, yemek için Portal'a girmek yerine asistanına yazıyorsun, o da gerçek veriyi çekip cevaplıyor.

İTÜ MCP bilgisayarında çalışan küçük bir programdır. Claude, Cursor veya Codex gibi bir asistana İTÜ sistemlerini okuma yeteneği kazandırır. Kod yazmayı bilmen gerekmez, kurup soru sorman yeterli.

Sen yazarsın	O bakar
"Bu hafta hangi ödevlerim var?"	Ninova
"Vize notlarım açıklandı mı?"	OBS
"Bugün yemekte ne var?"	Portal
"Bu dersi geçen yıl kim verdi, kaç kişi AA aldı?"	Ders arşivi
"Kütüphanede bu kitap var mı?"	Kütüphane kataloğu
"Ödevim için uyku ve akademik başarı üzerine makale bul"	Makale indeksi, kütüphane veritabanları
"Okunmamış maillerimi özetle"	İTÜ Mail
"FIZ 102E izlencesini ve duyurularını oku"	Moodle ve havuz siteleri
"Bu şubede yer açılınca haberim olsun"	Kontenjan takibi
"Ders programımı telefonumun takvimine ekle"	Takvim dosyası (.ics)

Şifren bilgisayarından çıkmaz. Program yalnızca İTÜ'nün kendi sunucularıyla konuşur.

İstanbul Teknik Üniversitesi ile resmi bir bağlantısı yoktur.

3 adımda kur

Python 3.11 veya üstü gerekir. Yüklü değilse python.org adresinden kurabilirsin.

1. Programı kur

pipx install "itu-mcp[keyring]"

pipx yoksa pip install --user "itu-mcp[keyring]" da olur.

2. Giriş bilgilerini kaydet ve asistanına bağla

itu-mcp setup

itu-mcp connect

itu-mcp setup İTÜ e-postanı ve şifreni sorar. Şifre yazarken ekranda görünmez ve hiçbir dosyaya yazılmaz, işletim sisteminin anahtar zincirine kaydedilir (Windows Kimlik Bilgileri Yöneticisi, macOS Anahtar Zinciri, Linux'ta GNOME Keyring ya da KWallet).

itu-mcp connect sunucuyu Claude Desktop, Claude Code ve Cursor ayarlarına şifresiz olarak ekler. Diğer ayarlarına dokunmaz, dosyanın yedeğini alır. Ne yapacağını önce görmek istersen itu-mcp connect --dry-run yaz. Tek bir asistan için: itu-mcp connect claude-desktop (ya da claude-code, cursor).

Anahtar zinciri istemiyorum ya da Codex kullanıyorum

Şifreyi asistanın ayarına elle de yazabilirsin.

Claude Code

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

Codex CLI

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

Claude Desktop ve Cursor için hazır ayar dosyaları examples/ klasöründe. Adım adım anlatım: docs/installation.md.

3. Sor

Asistanı yeniden başlat ve yaz:

Ninova'daki derslerimi listele

Bir liste geldiyse kurulum tamam.

Çalışmadı, ne yapmalıyım?

Önce şunu çalıştır:

itu-mcp doctor

Her satır OK, UYARI ya da HATA ile başlar ve OK olmayan satırın altında çözümü yazar. Girişi de denemesi için itu-mcp doctor --online yaz.

Giriş hata veriyorsa kullanıcı adını tam e-posta olarak yazdığından emin ol (ad.soyad@itu.edu.tr, yalnızca ad.soyad değil).
Komut bulunamıyorsa terminali kapatıp yeniden aç. pipx kurulumdan sonra yeni bir terminal ister.
Asistan aracı görmüyorsa asistanı tamamen kapatıp açmayı dene.
Hâlâ olmuyorsa bir sorun kaydı aç, ekran çıktısını ekle. Şifreni yazma.

Şifre vermek istemiyor musun? Ders programı, final tarihleri, not dağılımları, ders arşivi, mekik saatleri ve kütüphane kataloğu gibi herkese açık bilgiler şifresiz de çalışır. itu-mcp setup adımını atlayıp yalnızca itu-mcp connect çalıştırman yeterli.

Neler sorabilirsin?

Aşağıdakiler Claude Code'a yazılmış örnek sorular. Sen kendi cümlelerinle sorabilirsin, hangi aracın çağrılacağını asistan seçer. Çıktılar örnektir, sende kendi verin görünür.

Ödev takibi

> Bu hafta hangi ödevlerimin teslimi var?

● itu · get_upcoming_deadlines

Bu hafta 2 teslimin var:

BLG 223E Ödev 3 Perşembe 23:59, 2 gün kaldı Henüz yüklenmemiş

MAT 210E Proje raporu Pazar 23:59, 5 gün kaldı Yüklendi

Dersi kim verdi, nasıl geçti?

> BLG 223E geçen güz nasıl geçmiş?

● itu · archive_grade_distribution

2025-2026 Güz, 176 öğrenci:

AA 9 CC+ 19 BA+ 12 CC 21 BB+ 18 FF 38

En kalabalık not FF (38 kişi). AA alan 9 kişi var.

Kayıt haftası

> 12469, 12554 ve 12583 CRN'leri

çakışıyor mu?

● itu · check_course_conflicts

1 çakışma buldum:

Salı 08:30-10:29 BLG 223E ile BLG 345E üst üste

12583 (BLG 422E) sorunsuz. BLG 345E için başka şube arayayım mı?

Ön şart kontrolü

> BLG 335E'yi bu dönem alabilir miyim?

● itu · explain_course_eligibility

Henüz alamazsın.

Gereken: BLG 223E (en az DD) Durumun: BLG 223E bu dönem kayıtlı, notu açıklanmamış

BLG 223E'yi geçersen gelecek dönem açılıyor.

Günlük işler

> Bugün yemekte ne var, mekik kaçta?

● itu · get_cafeteria_menu ● itu · get_shuttle_schedule

Öğle yemeği: Mercimek çorbası, tavuk sote, pirinç pilavı, sütlaç

Ayazağa'dan sonraki mekik 13:30.

Not ve ortalama

> Bu dönem hepsinden BB alırsam

ortalamam kaç olur?

● itu · obs_simulate_cumulative_gpa

Şu anki GANO: 2.08 Dönem tahmini: 3.00 Dönem sonu GANO: 2.74

Tekrar aldığın 2 ders eski notun yerine sayıldı, 1 ders yeni eklendi.

Bu bir tahmin, resmi ortalama OBS'de açıklanır.

Daha fazla fikir:

"EEF 211E sınıf dosyalarındaki son PDF'i özetle."
"Danışmanım kim, staj durumum ne?"
"Transkriptimi indir."
"BBB binasında şu an boş derslik var mı?"
"BLG 223E'yi geçersem hangi dersler açılır?"
"Mezuniyetime kaç ders kaldı, gelecek dönem hangilerini almalıyım?"
"Kütüphanede Introduction to Algorithms var mı?"
"Son okunmamış maillerimi listele, ekindeki PDF'i özetle."

Asistanın / menüsünde hazır akışlar da var: weekly_briefing (haftalık özet), plan_next_term (gelecek dönem planı), registration_week (kayıt haftası kontrolü), check_course_eligibility, research_course ve gpa_scenario.

Sık sorulanlar

Şifrem nereye gidiyor?

Hiçbir yere. Program senin bilgisayarında çalışır ve şifreni yalnızca İTÜ'nün kendi giriş sayfasına gönderir, tıpkı tarayıcının yaptığı gibi. Arada bizim ya da başkasının bir sunucusu yoktur. Kod açık, istersen kendin bakabilirsin.

Bu resmi bir İTÜ uygulaması mı?

Hayır. Öğrenciler tarafından yazılmış açık kaynak bir projedir, İTÜ ile resmi bağlantısı yoktur. Yalnızca kendi hesabınla kullan.

Hesabımda bir şeyi değiştirebilir mi?

Neredeyse her şey yalnızca okur. İki istisna var ve ikisi de senin açık onayın olmadan çalışmaz:

Ödev yükleme. Önce neyi nereye yükleyeceğini gösterir, sen onaylayınca yükler.
Kayıt taslağı kaydetme. Varsayılan olarak kapalıdır. Açsan bile taslaktan ders silinecekse durur ve sana sorar.

İkisinde de, asistanın destekliyorsa, program göndermeden hemen önce sana doğrudan bir onay penceresi açar: hangi dosya, hangi ödev, hangi CRN'ler yazılacak, hangileri taslaktan çıkacak. Asistanın kendi kendine "onaylıyorum" demesi bu pencereyi atlatamaz. Onaylamazsan hiçbir şey gönderilmez.

Ders kaydı yapmaz, ders bırakmaz, mail göndermez.

Verdiği cevaba güvenebilir miyim?

Veriyi doğrudan İTÜ sistemlerinden çeker, uydurmaz. Yine de OBS bazı bilgileri hesaba göre farklı döndürebiliyor. Bir veri eksikse araç bunu açıkça söyler. Kayıt, mezuniyet ve not gibi önemli kararlarda son sözü her zaman OBS'nin kendi sayfası söyler.

Hangi asistanlarla çalışıyor?

MCP destekleyen her istemciyle: Claude Code, Claude Desktop, Cursor, Codex ve benzerleri. ChatGPT ya da Claude.ai gibi web arayüzleri için uzak sunucu kurulumu gerekir, anlatımı docs/advanced.md içinde.

Yer açılınca haber verebilir mi?

Kısmen. Dolu bir şubenin CRN'ini izleme listesine ekleyebilirsin (watch_course_sections), sonra "izlediğim şubelerde yer açıldı mı" diye sorduğunda son kontrolden bu yana ne değiştiğini söyler. Giriş gerektirmez.

Ama program arka planda çalışmaz ve kendiliğinden bildirim göndermez. Kontenjan yalnızca sen sorduğunda okunur. Düzenli takip istiyorsan asistanında birkaç dakikada bir bu soruyu soran zamanlanmış bir görev kurman gerekir.

Araç sayısı çok fazla, azaltabilir miyim?

Evet. Araçlar gruplara ayrılmış durumda

Solo se muestra el principio; lee el resto en el repo

İTÜ MCP

Resumen

Los tres pilares de PopNx MCP

Qué puedes hacer con él

Instalación

Antes de instalar

Valores que debes completar

Qué puede hacer

Revisiones básicasi

El creador coincide con el repo

Sigue en mantenimiento

Tiene licencia

El endpoint responde

Inicio de sesión con OAuth

Sin instrucciones ocultas en las descripciones de herramientas

Comparado con otros en Otrosi

Preguntas frecuentes

Alternativas

Spec Driven Development

Remote Desktop Commander

Cosas Guapas: buscador de regalos

README del creador

In English

Bu ne işe yarıyor?

3 adımda kur

Neler sorabilirsin?

Sık sorulanlar