ufind-mcp

u:find를 위한 MCP 서버로, University of Vienna의 강좌 목록입니다. 어시스턴트에게 학과가 이번 학기에 무엇을 제공하는지, 강좌가 언제 열리는지, 누가 가르치는지, 또는 강의실이 어디인지 물어보세요. 읽기 전용이며 계정이나 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 미만인 논리학 강좌를 찾아주세요.

Benjamin Schnieder는 이번 겨울에 무엇을 가르치나요?

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

면책 조항

이 프로젝트는 University of Vienna와 제휴되어 있지 않으며, University of Vienna의 보증이나 지원을 받지 않습니다. 이 프로젝트는 문서화된 공개 API의 일부가 아닌 엔드포인트를 읽기 때문에 언제든지 작동이 중단될 수 있습니다. 자신의 학업 목적으로 사용하고 기본 요청 속도 제한을 유지하세요. 보장된 액세스가 필요하다면 대학교에 문의하세요.

라이선스

MIT