fuxam-student-mcp
Fuxam Student MCP
Nutze Codex, Claude und andere lokale MCP-Clients, um deine Fuxam-Module, Lerneinheiten, deinen Fortschritt, deinen Stundenplan und deine Semesteroptionen zu erkunden.
Der Server läuft auf deinem Computer und kommuniziert direkt mit Fuxam. Er liefert dem Agenten nützliche Fakten aus der Quelle und kombinierbare Werkzeuge, anstatt zu versuchen, ein Semester für dich auszuwählen.
Lass deinen Agenten die Einrichtung übernehmen
Kopiere diesen Prompt in einen neuen Chat mit Codex oder Claude:
Set up Fuxam Student MCP for me using this documentation:
https://codecampus.tools/docs/fuxam-student-mcp
Detect which supported MCP client I am using and follow only its current instructions. Install the latest public release locally and configure it as a stdio MCP server. Complete every step you can directly, and pause only for a client UI or secret-entry action I must perform.
Never ask me to paste my Fuxam `__client` cookie into this chat, and never print or log it. When the credential is required, tell me exactly how to enter it directly into the client's local MCP configuration or secure installer prompt.
After configuration:
1. Verify the MCP entry exists without displaying the credential.
2. Start the server and confirm its tools are available.
3. Tell me if I need to restart the client or open a new chat.
4. Run one read-only check: show the module categories and learning units I can currently choose from.
Do not book or unbook courses, or join or leave waitlists, during setup.Du installierst lieber selbst? Folge den manuellen Schritten unten.
Related MCP server: MCP UJI Academic Server
Voraussetzungen
Ein Fuxam-Konto der CODE University
Node.js 26 oder neuer für die Installation über die Befehlszeile
Codex, Claude Code oder Claude Desktop
Dein Fuxam-Sitzungscookie abrufen
Fuxams kurzlebige Sitzungstokens werden über das Clerk-__client-Cookie erneuert.
Melde dich in deinem Browser bei fuxam.app an.
Öffne die Entwicklertools des Browsers.
Wähle in der Cookie-Ansicht unter Anwendung/Speicher
https://clerk.fuxam.appaus.Kopiere den Wert des
__client-Cookies.
Behandle diesen Wert wie ein Passwort. Füge ihn nicht in Chats ein, committe ihn nicht und zeige ihn nicht in Screenshots.
Installation
ChatGPT-/Codex-App und Codex-CLI
Die installierte ChatGPT-/Codex-App und die Codex-CLI teilen sich die lokale Codex-MCP-Konfiguration:
codex mcp add fuxam \
--env FUXAM_CLERK_CLIENT='<your __client cookie>' \
-- npx -y fuxam-student-mcpÖffne nach dem Hinzufügen des Servers eine neue Codex-Aufgabe.
Claude Code
claude mcp add --scope user \
-e FUXAM_CLERK_CLIENT='<your __client cookie>' \
fuxam -- npx -y fuxam-student-mcpClaude Desktop
Lade die .mcpb-Datei aus dem passenden GitHub-Release herunter, öffne sie mit Claude Desktop und füge das Clerk-Cookie ein, wenn du dazu aufgefordert wirst. Das Bundle führt dasselbe MCP lokal aus und markiert das Cookie als sensible Konfiguration.
Andere lokale MCP-Clients
Konfiguriere einen stdio-Server mit dieser ausführbaren Datei und dieser Umgebungsvariable:
{
"command": "npx",
"args": ["-y", "fuxam-student-mcp"],
"env": {
"FUXAM_CLERK_CLIENT": "<your __client cookie>"
}
}Der äußere Konfigurationsschlüssel unterscheidet sich je nach Client. Verwende die normalen lokalen stdio-MCP-Einstellungen des Clients.
Ausprobieren
Gute erste Prompts sind zum Beispiel:
„Zeig mir die Modulkategorien und Lerneinheiten, aus denen ich aktuell wählen kann.“
„Hilf mir, diese drei Module zu vergleichen, einschließlich Voraussetzungen, Fortschritt, Dozierenden, Terminen und Arbeitsaufwand.“
„Schau dir meinen Studienplan und meinen aktuellen Fortschritt an und hilf mir dann, ein realistisches Semester zusammenzustellen.“
„Prüfe, ob dieser vorgeschlagene Satz von Lerneinheiten Terminkonflikte aufweist.“
„Welche Fristen und Termine habe ich im nächsten Monat?“
Der Agent kann nach Kategorie/Tag oder Text stöbern, Module und Lerneinheiten stapelweise prüfen, das Ergebnis mit deinem Fortschritt vergleichen und einen vorgeschlagenen Kursatz auf Konflikte prüfen.
Funktionen
Planung und Erkundung:
explore_learning_optionssearch_fuxamget_study_planlist_enrolled_courseslist_bookable_coursesget_learning_unit_detailsget_module_detailsget_module_attemptsget_exam_details
Stundenplan und Arbeitsaufwand:
list_student_appointmentslist_course_appointmentslist_course_deadlineslist_applicable_excluded_dateslist_todoslist_pinned_coursesget_layer_pathcheck_course_conflicts
Kontoänderungen:
book_courseunbook_coursejoin_waitlistleave_waitlist
Die vier Kontoänderungs-Werkzeuge wirken sich auf dein echtes Fuxam-Konto aus. Sie sind für MCP-Clients als Schreiboperationen markiert, und jede Änderung überprüft den resultierenden Fuxam-Zustand. Die Buchung führt nicht stillschweigend zuerst eine Konfliktprüfung durch.
Wie Agenten es verwenden sollten
Beginne bei offener Planung mit explore_learning_options und list_enrolled_courses. Grenze nach Kategorie oder Suchanfrage ein, prüfe dann die engere Auswahl stapelweise über get_module_details, get_learning_unit_details und get_module_attempts. Prüfe den vollständigen vorgeschlagenen Satz mit check_course_conflicts, bevor du die Abwägungen präsentierst.
Die Bezeichner sind wichtig:
Die Kurs-
idwird für Buchungen, Wartelisten und Konfliktprüfungen verwendet;layerIdoderlayer_idwird für Termine und Fristen verwendet;courseModuleIdist die stabile Modul-ID;moduleVersionIdidentifiziert eine Curriculum-Version;organizationTermIdidentifiziert ein akademisches Semester.
Die aus Fuxam-Importen abgeleiteten Abschluss-Summen können gelegentlich hinter konkreten Versuchs- oder gradedAt-Datensätzen zurückbleiben. Agenten sollten bei Abweichungen die konkreten Datensätze bevorzugen.
Fehlerbehebung
FUXAM_AUTH_REQUIRED
: Melde dich erneut bei Fuxam an, kopiere das aktuelle Clerk-__client-Cookie, entferne den alten MCP-Eintrag und füge ihn mit dem neuen Wert wieder hinzu.
codex mcp remove fuxam
claude mcp remove --scope user fuxamFUXAM_UNSUPPORTED_INSTITUTION
: Diese Version unterstützt die Fuxam-Umgebung der CODE University.
FUXAM_CONTEXT_REQUIRED
: Der Server konnte keinen aktiven Kohorten- und Studienprogramm-Kontext identifizieren. Gib beim Eröffnen eines Issues den vollständigen Fehler an, aber niemals dein Cookie, Header oder rohe Fuxam-Antwortdaten.
Teilergebnisse
: Einige kuratierte Abfragen kombinieren mehrere Fuxam-Bereiche. Wenn ein optionaler vorgelagerter Bereich vorübergehend nicht verfügbar ist, gibt das MCP die Bereiche zurück, die es abrufen konnte, mit partial: true und kennzeichnet, was erneut versucht werden kann.
Datenschutz
Version 0.1 erhebt keine Telemetrie. Deine Fuxam-Anmeldedaten und deine Studiendaten bleiben auf deinem Computer, abgesehen von direkten Anfragen des lokalen MCP an Fuxam und Clerk. Tool-Ergebnisse werden an den von dir gewählten MCP-Client gesendet und unterliegen dessen eigenen Datenkontrollen.
Lizenz
Die nichtkommerzielle Nutzung ist unter der PolyForm Noncommercial License 1.0.0 lizenziert. Für die kommerzielle Nutzung ist eine separate schriftliche Lizenz von Maximilian Spitzer erforderlich; kontaktiere den Autor über GitHub.
Entwicklung
npm ci
npm run check
npm run test:package
npm run package:mcpbDer Paket-Smoke-Test installiert das generierte npm-Tarball in einem sauberen temporären Verzeichnis, verhandelt MCP über stdio, listet seine Tools auf und überprüft das Verhalten beim Start ohne Anmeldedaten. Tests verwenden niemals echte Studierenden-Anmeldedaten oder führen eine Fuxam-Änderung durch.
Projektstatus
Dies ist ein inoffizieller, von Studierenden gebauter Client, der mit Genehmigung von CODE University und Fuxam veröffentlicht wurde. Fuxam bleibt die maßgebliche Quelle für akademische Aufzeichnungen, Voraussetzungen, Verfügbarkeit und Kontostatus.
Available Tools
21 toolsbook_courseBook CourseA
Book one learning-unit course ID on the real student account and verify it with a fresh enrolled-course read. This does not implicitly check conflicts; call check_course_conflicts first when schedule compatibility matters.
Inputs: courseId (required).
check_course_conflictsCheck Course ConflictsARead-onlyIdempotent
Ask Fuxam to evaluate a proposed set of learning-unit course IDs against one another and known appointments. An empty upstream array means Fuxam reported no conflict. This tool does not book or modify anything.
Inputs: courseIds (required), includeAppointmentsForCourseIds.
explore_learning_optionsExplore Learning OptionsARead-onlyIdempotent
Explore the catalog when the student does not yet know module or LU names. With no filters, returns the complete raw study plan, elective-group facets with module/current-LU counts, and concise summaries of all current bookable LUs. It tolerates an unavailable study-plan or catalog section and reports partial results in warnings. Call it again with electiveGroupIds to browse those categories or with query for thematic text search. Then use get_module_details and get_learning_unit_details for the shortlist.
Inputs: query, electiveGroupIds.
get_exam_detailsGet Exam DetailsBRead-onlyIdempotent
Drill into one assessment attempt. Returns dates, scheduling, submission eligibility, published outcome, request history, alternative-assessment state, and academic gates unchanged. Omit cohortId to use the configured student's cohort.
Inputs: examId (required), moduleVersionId (required), organizationTermId (required), cohortId, +1 more.
get_layer_pathGet Layer PathARead-onlyIdempotent
Resolve a Fuxam layer ID to its structural hierarchy. This is useful for understanding where a course, module, or content layer sits in the curriculum or organization tree.
Inputs: layerId (required).
get_learning_unit_detailsGet Learning Unit DetailsARead-onlyIdempotent
Batch-inspect several learning-unit course IDs. Returns each complete current course record plus a large page of its appointments and deadlines, preserving upstream fields. Missing IDs are reported separately; schedule or deadline sections report unavailable when Fuxam exposes the catalog LU but withholds that course endpoint. Use this after narrowing a semester shortlist; it does not rank, check conflicts, or mutate anything.
Inputs: courseIds (required), language, includeDeadlines, includeAppointments.
get_module_attemptsGet Module AttemptsARead-onlyIdempotent
Batch attempt history, assessment requirements, attendance fulfillment, grades, and academic rules for several module versions. Each module is returned independently so one unavailable record does not discard the others. Use moduleVersionIds from the study plan or courses' connectedModule records.
Inputs: moduleVersionIds (required).
get_module_detailsGet Module DetailsARead-onlyIdempotent
Batch-inspect several module versions. For each module, returns Fuxam's catalog settings and requirements, module information, associated learning units for the optional academic term, and the student's attempt and academic-rule state. In a learning-unit connectedModule record, pass moduleId as courseModuleId and pass moduleVersionId unchanged.
Inputs: modules (required).
get_study_planGet Study PlanARead-onlyIdempotent
Return the student's module elections, elective pools, available terms, attempt summaries, and study-plan state unchanged. Use returned organizationTermId and moduleVersion.id values with the drill-down tools.
Inputs: focusId, organizationTermId.
join_waitlistJoin WaitlistB
Join a course waitlist on the real student account and re-read the booking catalog to report the resulting position.
Inputs: courseId (required).
leave_waitlistLeave WaitlistADestructive
Leave a course waitlist on the real student account and re-read the booking catalog to verify the resulting state.
Inputs: courseId (required).
list_applicable_excluded_datesList Applicable Excluded DatesARead-onlyIdempotent
Return institution-wide excluded dates applicable to the student in an ISO-8601 date or datetime interval, such as holidays or closure periods that affect scheduling.
Inputs: to (required), from (required).
list_bookable_coursesList Bookable CoursesARead-onlyIdempotent
Return one upstream page of bookable learning units unchanged, including capacity, enrollment, waitlist state, descriptions, and connected modules. Use id for booking/waitlists, layerId for course schedules, and connectedModule.moduleVersionId for curriculum tools. Follow pageCount to inspect further pages.
Inputs: page, search, perPage.
list_course_appointmentsList Course AppointmentsARead-onlyIdempotent
Return one course's appointment page unchanged. Supply layerId from enrolled or bookable course data, not the learning-unit course id.
Inputs: layerId (required), limit, cursor, direction.
list_course_deadlinesList Course DeadlinesBRead-onlyIdempotent
Return one course's deadline items and pagination metadata unchanged. Supply layerId from enrolled or bookable course data.
Inputs: layerId (required), limit, cursor, language.
list_enrolled_coursesList Enrolled CoursesARead-onlyIdempotent
Return the student's enrolled course records unchanged, including descriptions, educators, tags, content blocks, status, and identifiers. A course id and layer_id are different identifiers.
Inputs: search.
list_pinned_coursesList Pinned CoursesARead-onlyIdempotent
Return the student's pinned-course records unchanged. Pinned courses can indicate the student's current working set but are not a recommendation signal.
Inputs: no named parameters.
list_student_appointmentsList Student AppointmentsCRead-onlyIdempotent
Return one page of the student's agenda unchanged, including appointment times, locations, organizers, attendance settings, and pagination state. Use the returned cursor for another page.
Inputs: limit, cursor, direction, showPastAppointments.
list_todosList To-DosARead-onlyIdempotent
Return the student's Fuxam content-block workload and current statuses unchanged. This exposes concrete outstanding, in-progress, completed, reviewed, and locked work for planning workload.
Inputs: showLocked, timePeriod, showReviewed, showCompleted, +2 more.
search_fuxamSearch FuxamARead-onlyIdempotent
Search Fuxam entities and return the upstream result unchanged. Use this to discover course, module, term, appointment, and exam IDs before calling specialized tools.
Inputs: query (required), limit, types, offset.
unbook_courseUnbook CourseADestructive
Unbook one learning-unit course ID from the real student account and verify its absence with a fresh enrolled-course read.
Inputs: courseId (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 21 tools
Each tool has a clearly distinct purpose, ranging from search and listing to booking and waitlist management. Overlaps like list_enrolled_courses vs list_bookable_courses are differentiated by their scope (enrolled vs bookable), and get_learning_unit_details vs get_module_details target different entities.
Most tools follow a verb_noun pattern (list_*, get_*, book_*, unbook_*, join_*, leave_*). Minor inconsistencies exist, such as 'search_fuxam' and 'explore_learning_options' not using the same prefix structure, but the overall naming is coherent and readable.
With 21 tools, the set is fairly large but justified by the breadth of student operations: reading data, booking, waitlists, conflict checking, and scheduling. The count is on the higher end but still within a reasonable range for a comprehensive student management server.
The tool surface covers core student actions: search, list, view details, book/unbook, join/leave waitlists, check conflicts, and access appointments, deadlines, exams, todos, and pinned courses. Minor gaps like a dedicated 'get_student_info' or update operation exist, but the core domain is well represented.
Maintenance
Related MCP Connectors
Read-only MCP server for ClassQuill, a tutoring-business-management platform.
Model Context Protocol server for Studex tools, notifications, and profile integrations
Governed data discovery, exact queries, decisions, simulations, and runtime utilities over MCP.
Remote MCP for TehProf Booking: browse resources & availability, create & cancel reservations.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables querying academic data from Universitat Jaume I, including subjects, degrees, locations, and schedules, via MCP-compatible clients.MIT
- AlicenseNot gradedqualityDmaintenanceEnables querying academic data such as subjects, degrees, locations, and schedules from Universitat Jaume I via MCP tools.MIT
- FlicenseNot gradedqualityDmaintenanceRemote MCP connector providing live, structured access to CMU Courses public data including courses, prerequisites, schedules, instructors, gen-eds, and final-exam times to help students plan schedules.-
- FlicenseNot gradedqualityDmaintenanceMCP server for querying student information, validating result data, and analyzing student results from a local database.-