İTÜ MCP — MCP-сервер для Claude Code: что делает и как установить
MCP-сервер подключает ИТ-системы İTÜ к ИИ-ассистенту. Он пригодится для проверки курсов, оценок, заданий, расписания и каталога библиотеки.
claude mcp add --env NINOVA_USERNAME=<NINOVA_USERNAME> --env NINOVA_PASSWORD=<NINOVA_PASSWORD> --env NINOVA_MAIL_USERNAME=<NINOVA_MAIL_USERNAME> --env NINOVA_MAIL_PASSWORD=<NINOVA_MAIL_PASSWORD> --env NINOVA_LIBRARY_NAME=<NINOVA_LIBRARY_NAME> --transport stdio itu-mcp -- uvx itu-mcpЧто делает İTÜ MCP
İTÜ MCP даёт ассистенту доступ к Ninova, OBS, Portal, Moodle, сайтам курсов, ИТУ Mail, каталогу библиотеки и архиву прошлых курсов. Через обычный запрос можно узнать о заданиях, оценках, расписании, местах в группе, меню и статусе регистрации. Сервер также умеет отслеживать открывшиеся места и создавать файл календаря .ics.
Сервер работает локально и по умолчанию только читает данные. Загрузка задания и сохранение черновика регистрации требуют подтверждения. Для закрытых данных нужны учётные данные İTÜ; пароль хранится на компьютере и отправляется только на страницу входа İTÜ. Для запуска требуется Python 3.11 или выше и uvx.
В Claude Code сервер добавляется командой claude mcp add; доступны также Codex, Cursor, GitHub Copilot и Gemini CLI. Поскольку проект не связан официально с İTÜ, вопросы по доступу зависят от работы её систем и учётной записи.
Какие задачи решает
- проверить задания и сроки сдачи
- сверить оценки и прогресс выпуска
- найти курс, группу или свободное место
- посмотреть расписание и объявления
- найти книгу в каталоге библиотеки
Примеры запросов агенту
- Покажи мои ближайшие задания в Ninova и сроки сдачи.
- Проверь оценки в OBS и посчитай итоговый GPA для заданных оценок.
- Найди свободные места в группах
MAT 210Eи добавь расписание в файл.ics.
Как установить İTÜ MCP
Командой платформы
claude mcp add --env NINOVA_USERNAME=<NINOVA_USERNAME> --env NINOVA_PASSWORD=<NINOVA_PASSWORD> --env NINOVA_MAIL_USERNAME=<NINOVA_MAIL_USERNAME> --env NINOVA_MAIL_PASSWORD=<NINOVA_MAIL_PASSWORD> --env NINOVA_LIBRARY_NAME=<NINOVA_LIBRARY_NAME> --transport stdio itu-mcp -- uvx itu-mcpВместо <…> подставьте свои значения. Ещё 2 переменные окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from itu-mcp <команда>
Командой платформы
codex mcp add itu-mcp --env NINOVA_USERNAME=<NINOVA_USERNAME> --env NINOVA_PASSWORD=<NINOVA_PASSWORD> --env NINOVA_MAIL_USERNAME=<NINOVA_MAIL_USERNAME> --env NINOVA_MAIL_PASSWORD=<NINOVA_MAIL_PASSWORD> --env NINOVA_LIBRARY_NAME=<NINOVA_LIBRARY_NAME> -- uvx itu-mcpВместо <…> подставьте свои значения. Ещё 2 переменные окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from itu-mcp <команда>
Файл настроек
{
"mcpServers": {
"itu-mcp": {
"command": "uvx",
"args": [
"itu-mcp"
],
"env": {
"NINOVA_USERNAME": "<NINOVA_USERNAME>",
"NINOVA_PASSWORD": "<NINOVA_PASSWORD>",
"NINOVA_MAIL_USERNAME": "<NINOVA_MAIL_USERNAME>",
"NINOVA_MAIL_PASSWORD": "<NINOVA_MAIL_PASSWORD>",
"NINOVA_LIBRARY_NAME": "<NINOVA_LIBRARY_NAME>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 2 переменные окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from itu-mcp <команда>
Файл настроек
{
"servers": {
"itu-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"itu-mcp"
],
"env": {
"NINOVA_USERNAME": "<NINOVA_USERNAME>",
"NINOVA_PASSWORD": "<NINOVA_PASSWORD>",
"NINOVA_MAIL_USERNAME": "<NINOVA_MAIL_USERNAME>",
"NINOVA_MAIL_PASSWORD": "<NINOVA_MAIL_PASSWORD>",
"NINOVA_LIBRARY_NAME": "<NINOVA_LIBRARY_NAME>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 2 переменные окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from itu-mcp <команда>
Командой платформы
gemini mcp add -e NINOVA_USERNAME=<NINOVA_USERNAME> -e NINOVA_PASSWORD=<NINOVA_PASSWORD> -e NINOVA_MAIL_USERNAME=<NINOVA_MAIL_USERNAME> -e NINOVA_MAIL_PASSWORD=<NINOVA_MAIL_PASSWORD> -e NINOVA_LIBRARY_NAME=<NINOVA_LIBRARY_NAME> itu-mcp uvx itu-mcpВместо <…> подставьте свои значения. Ещё 2 переменные окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from itu-mcp <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о İTÜ MCP
Как установить İTÜ MCP в Claude Code?
Выполните `claude mcp add itu-mcp -e NINOVA_PASSWORD=<NINOVA_PASSWORD> -e NINOVA_MAIL_PASSWORD=<NINOVA_MAIL_PASSWORD> -e NINOVA_LIBRARY_ID=<NINOVA_LIBRARY_ID> -e NINOVA_LIBRARY_PIN=<NINOVA_LIBRARY_PIN> -- uvx itu-mcp`.
Что делает İTÜ MCP?
Он подключает ИИ-ассистента к системам İTÜ и позволяет получать сведения о курсах, заданиях, оценках, расписании, библиотеке и других сервисах.
Нужен ли пароль İTÜ для работы?
Открытые сведения работают без пароля. Для личных данных нужны учётные данные İTÜ; пароль остаётся на компьютере.
