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.
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.
1 maintainer
Metadata
1 maintainer
Release files for hisinone-mcp 0.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| hisinone_mcp-0.1.0.tar.gz | 12.4 kB | Without provenance | Details for hisinone_mcp-0.1.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| hisinone_mcp-0.1.0-py3-none-any.whl | Python 3 | none | any | Details for hisinone_mcp-0.1.0-py3-none-any.whl |
Total release size: 21.6 kB
Release files / hisinone_mcp-0.1.0.tar.gz
| Download URL | hisinone_mcp-0.1.0.tar.gz |
|---|---|
| Size | 12.4 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
b1c407c1356070a2166f4686573cfa662bdd52fa608a71bc635155d51f07f219
|
|
BLAKE2b-256 checksum How to use checksums |
4b622705c32b936abb2051eec538beae67cf8a01ccbb75677b47533c28a0804c
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.13.6 {"installer":{"name":"uv","version":"0.13.6","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"13","id":"trixie","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Release files / hisinone_mcp-0.1.0-py3-none-any.whl
| Download URL | hisinone_mcp-0.1.0-py3-none-any.whl |
|---|---|
| Size | 9.1 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
c9aead6eb12cebcaed54fd8996af0a40957295aff16392a984385eca49f7e480
|
|
BLAKE2b-256 checksum How to use checksums |
b74f27f5927cfaca08cb28e469784b117ce2cc7fd4adeef62daad7e47624679b
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.13.6 {"installer":{"name":"uv","version":"0.13.6","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"13","id":"trixie","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Security for hisinone-mcp 0.1.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.
