Skip to main content
Glama
Sign In
hisinone-mcp

hisinone-mcp

by smlfg
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Remote

hisinone-mcp

MCP-Server für HISinOne-Campusportale: öffentlich Veranstaltungen suchen und Details lesen, nach dem Login den persönlichen Stundenplan und die Leistungsübersicht abrufen. Ausschließlich lesend.

Der Server ist eine dünne Hülle um den Kern der hisinone-cli: Er importiert hisinone.client, hisinone.config und hisinone.parse und ruft dieselben Funktionen wie hisinone suche, hisinone veranstaltung, hisinone stundenplan und hisinone noten auf.

Schnellstart

uvx hisinone-mcp

Für Stundenplan und Noten vorher einmal im Terminal anmelden; die Sitzung liegt unter ~/.config/hisinone-cli/ (0600):

uvx --from hisinone-cli hisinone login

Danach startet der MCP-Client den Server selbst. Suche und Veranstaltungsdetails funktionieren ohne Login.

Related MCP server: ufora-mcp

In Claude Desktop / Cursor nutzen

{"mcpServers":{"hisinone":{"command":"uvx","args":["hisinone-mcp"],"env":{"HISINONE_BASE_URL":"https://campus.uni-freiburg.de/qisserver/pages/cs/sys/portal/hisinoneStartPage.faces"}}}}

HISINONE_BASE_URL ist optional und überschreibt das Standardportal. Für eine andere Hochschule die Basis-URL der dortigen HISinOne-Instanz eintragen.

Claude Code

claude mcp add hisinone -e HISINONE_BASE_URL=https://campus.uni-freiburg.de/qisserver/pages/cs/sys/portal/hisinoneStartPage.faces -- uvx hisinone-mcp

Tools

Tool

Beschreibung

Login

search_courses

Veranstaltungen nach Titel, Nummer oder Lehrperson suchen

nein

get_course

Veranstaltung per Titel oder numerischer Unit-ID anzeigen

nein

get_timetable

Persönlichen Stundenplan für heute oder die Woche lesen

ja

get_grades

Persönliche Leistungsübersicht lesen

ja

Alle Tools sind lesend (readOnlyHint) und liefern strukturierte Daten plus lesbaren Text. Es gibt keine schreibenden Aktionen wie Belegung oder Prüfungsanmeldung. Fehler kommen als lesbare Meldung mit nächstem Schritt zurück, nie als Traceback und nie mit Noten oder Personendaten im Log.

Anmeldung und Konfiguration

Der MCP-Server fragt nie nach Passwörtern und nimmt keine Zugangsdaten als Tool-Argument an. Er nutzt die Sitzung, die hisinone login anlegt. Alternativ können HISINONE_USER und HISINONE_PASSWORD wie bei der CLI in der Umgebung stehen; ohne Sitzung und ohne diese Variablen nennen get_timetable und get_grades den nächsten Schritt hisinone login.

Variable

Default

Bedeutung

HISINONE_BASE_URL

Universität Freiburg

Portal-Basis-URL (andere Hochschule, Fake-Server)

HISINONE_USER

–

Benutzername für die Anmeldung ohne gespeicherte Sitzung

HISINONE_PASSWORD

–

Passwort nur für Agenten/Tests, wird nie gespeichert oder geloggt

Datenquelle

Die Daten stammen aus dem jeweiligen HISinOne-Campusportal über dessen Weboberfläche. Das Projekt ist inoffiziell, nicht mit den Hochschulen verbunden und greift ausschließlich lesend zu. Portaländerungen können die Auswertung brechen.

Lizenz

MIT, Copyright 2026 smlfg. Siehe LICENSE.

Available Tools

4 tools
get_courseA
Read-onlyIdempotent

Zeigt eine HISinOne-Veranstaltung per vollständigem Namen, eindeutigem Suchbegriff oder numerischer Veranstaltungs-ID mit Art, Semester, Lehrperson, Terminen und Räumen. Show a HISinOne course; no login required, read-only.

Inputs: name_or_id (required).

get_gradesA
Read-onlyIdempotent

Liest die persönliche HISinOne-Leistungsübersicht mit Modul, Prüfung, Note und Status. Benötigt die Sitzung aus hisinone login oder HISINONE_USER/HISINONE_PASSWORD aus der Umgebung; read-only.

Inputs: no named parameters.

get_timetableA
Read-onlyIdempotent

Liest den persönlichen HISinOne-Stundenplan für heute oder die ganze Kalenderwoche. Benötigt die Sitzung aus hisinone login oder HISINONE_USER/HISINONE_PASSWORD aus der Umgebung; read-only.

Inputs: week.

search_coursesA
Read-onlyIdempotent

Sucht öffentlich im HISinOne-Vorlesungsverzeichnis nach Titel, Veranstaltungsnummer oder Lehrperson und liefert die nummerierten Treffer. Search HISinOne courses; no login required, read-only.

Inputs: query (required), limit.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Deploy Server
    One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

    TDQS

    A4.1/5.0

    Scored across 4 tools

    Disambiguation5/5

    Each tool targets a distinct task: course discovery (search_courses), course detail (get_course), personal timetable (get_timetable), and personal grades (get_grades). The split between search and detail is natural rather than ambiguous, and the personal/read-only tools are clearly separated from the public catalog tools.

    Naming Consistency5/5

    All four tools follow a consistent snake_case verb_noun pattern: search_courses, get_course, get_timetable, get_grades. The only variation is plural vs singular object naming, which matches the semantics and does not impair predictability.

    Tool Count5/5

    Four tools is well-scoped for a focused read-only HISinOne client covering course search, course detail, timetable, and grades. Each tool has a clear reason to exist, and there is no redundant or filler surface.

    Completeness4/5

    The surface covers the core read-only student workflows implied by the descriptions: discovering courses, inspecting details, checking the timetable, and reading grades. Minor gaps might include explicit semester or exam-date queries, but the main lifecycle is well covered and login is handled outside the MCP tool set.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Resources

    Related MCP Connectors

    Related MCP Servers

    • librus-mcp

      TechAdrianPro
      F
      license
      A
      quality
      C
      maintenance
      Enables read-only access to a Librus Portal account, letting users list linked Synergia accounts and retrieve grades, attendance, timetable, homework, notices, and school information.
      3
      -

    • ufora-mcp

      LiamVDB1
      A
      license
      B
      quality
      B
      maintenance
      Enables AI clients to read a student's own UGent Ufora (D2L Brightspace) data, including courses, announcements, deadlines, grades, course materials, and PDF text, over stdio or local Streamable HTTP. All operations are read-only and run locally against the student's authenticated session.
      19
      2
      MIT

    • Personal Brightspace MCP

      Proscled
      A
      license
      A
      quality
      C
      maintenance
      Enables a tutor or assistant to read a student's Brightspace courses, deadlines, announcements, assignment instructions, course outlines, quiz metadata and released grades, plus search explicitly imported school notes and read course documents. Runs locally over stdio with read-only access and configurable tenant settings.
      18
      1
      MIT