git404hub

what is itu-mcp fr?

yatuk/itu-mcp — explained in plain English

Analysis updated 2026-05-18

6JavaScriptAudience · generalComplexity · 3/5LicenseSetup · easy

tl;dr

A local tool that connects Istanbul Technical University's course and student portals to AI assistants so students can ask about classes, grades, and campus life in plain language.

vibe map

mindmap
  root((repo))
    What it does
      Connects university systems to AI
      Answers coursework questions
      Answers public campus questions
    Tech stack
      Python
      MCP protocol
      FastMCP
    Use cases
      Check assignment deadlines
      Check grades and attendance
      Look up final exam schedule
      Search library catalog
    Audience
      University students
      ITU students specifically
    Setup
      Install via pipx
      Add login credentials
      Connect to Claude or Codex
    Privacy
      Credentials stay local
      No third party server
      Unofficial project

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

what do people make with this?

VIBE 1

Ask an AI assistant which assignments are due this week on the university course platform.

VIBE 2

Check grades, attendance, or a full transcript through natural language questions.

VIBE 3

Look up final exam schedules or open seats in a course without logging into the student portal.

VIBE 4

Check public campus information like shuttle times, pool hours, or library book availability.

what's the stack?

PythonMCPFastMCP

how it stacks up fr

yatuk/itu-mcpanil-matcha/open-ai-vibe-coding-coursearthurmoorgan/drift
Stars666
LanguageJavaScriptJavaScriptJavaScript
Last pushed2026-06-30
MaintenanceActive
Setup difficultyeasyeasymoderate
Complexity3/51/52/5
Audiencegeneralpm foundergeneral

Figures from each repo's GitHub metadata at analysis time.

how do i run it?

Difficulty · easy time til it works · 5min

Only useful to students with an active Istanbul Technical University account, some features require entering university login credentials.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

in plain english

This project connects a Turkish university's online systems to AI assistants like Claude, Cursor, and Codex, so students at Istanbul Technical University, known as ITU, can ask questions about their coursework in plain language instead of clicking through several separate web portals. It runs locally on the student's own computer and acts as a bridge, using a standard called the Model Context Protocol, between the AI assistant and the university's Ninova course platform, its OBS student records portal, and other campus services. With a student's own login credentials, the tool can answer questions such as which assignments are due this week, what grades or attendance look like for a specific class, who a student's academic advisor is, or pull up a transcript. Without needing any login at all, it can also answer public questions like when final exams are scheduled, whether a specific book is available in the university library, or when the campus shuttle and swimming pool are open, since that information is publicly available on official university sources. The project is built with attention to keeping login details private: passwords are stored locally on the student's own machine and are only sent to the university's own login, course, and portal systems, never to any third party server. A separate library account, if used, is kept in its own session apart from the main university login. The project makes clear it has no official relationship with the university itself. Setting it up involves installing the tool through Python's package tools, adding a student's university email and password to a local configuration file, and then connecting it to an AI assistant such as Claude Code or Codex with a short command. Once connected, the student can simply ask their assistant natural language questions about their coursework and university life. It is released under the MIT license.

prompts (copy fr)

prompt 1
Help me install itu-mcp and connect it to Claude Code with my university credentials.
prompt 2
Show me how to ask this tool about my registered courses for the current semester.
prompt 3
Explain how this project keeps my university login credentials private and local.
prompt 4
Walk me through the public tools I can use without logging in, like exam schedules or library search.

Frequently asked questions

what is itu-mcp fr?

A local tool that connects Istanbul Technical University's course and student portals to AI assistants so students can ask about classes, grades, and campus life in plain language.

What language is itu-mcp written in?

Mainly JavaScript. The stack also includes Python, MCP, FastMCP.

What license does itu-mcp use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is itu-mcp to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is itu-mcp for?

Mainly general.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.