ufind-mcp

MCP-сервер для u:find — каталога курсов Венского университета. Спросите своего ассистента, что предлагает факультет в этом семестре, когда проходят занятия, кто их ведёт или где находится аудитория. Только чтение, без аккаунта и без API-ключа.

Установка

git clone https://github.com/ParadoxTR/ufind-mcp.git
cd ufind-mcp
uv sync

Добавьте его в Claude Code:

claude mcp add ufind --scope user -- uv --directory /absolute/path/to/ufind-mcp run ufind-mcp

Или добавьте его в Claude Desktop, Cursor или любой другой MCP-клиент:

{
  "mcpServers": {
    "ufind": {
      "command": "uv",
      "args": ["--directory", "/absolute/path/to/ufind-mcp", "run", "ufind-mcp"]
    }
  }
}

Что можно спросить

Какие курсы предлагает программа Bachelor Informatik в 2026W?

Когда и где проходит курс 180013, и кто его ведёт?

Найди курсы по логике в следующем семестре объёмом менее 3 ECTS.

Что преподаёт Бенджамин Шнидер этой зимой?

Покажи модульную структуру учебного плана Master Philosophie.

Инструменты

Семестры записываются как 2026W (зима 2026/27) или 2027S. Каждый инструмент также принимает current, next и previous.

Конфигурация

Полезно знать

У u:find нет публичного API. Этот сервер читает XML-эндпоинты, которые используют мобильные клиенты, а для тех частей, которые эти эндпоинты не покрывают, — публичные веб-страницы. Это означает, что университет может менять что-либо без предупреждения. Запросы отправляются по одному с небольшой паузой, а каждый ответ кэшируется на диске, поэтому обычное использование не создаёт нагрузки на их серверы.

Семестр, который ещё не начался, неполон. Описания курсов, периоды регистрации и даты экзаменов часто остаются пустыми до начала семестра.

Пути в каталоге привязаны к конкретному семестру, поэтому у программы разный id в 2026W и в 2026S. Сервер находит программы по имени для запрошенного семестра и предупреждает, если путь относится к другому семестру.

Курс, который засчитывается в несколько модулей, появляется по одному разу для каждого модуля в списке программы. В выводе всегда указывается, сколько это записей и сколько различных курсов.

Тесты

uv run python tests/smoke.py      # live data, parsing and completeness
uv run python tests/mcp_smoke.py  # calls every tool over the MCP protocol

Отказ от ответственности

Этот проект не связан с Венским университетом, не одобрен и не поддерживается им. Он читает эндпоинты, не входящие в документированный публичный API, поэтому может перестать работать в любой момент. Используйте его для собственного обучения и сохраняйте ограничение частоты запросов по умолчанию. Если вам нужен гарантированный доступ, обратитесь в университет.

Лицензия

MIT