Skip to main content
Glama
fuxam-student-mcp

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.

  1. Melde dich in deinem Browser bei fuxam.app an.

  2. Öffne die Entwicklertools des Browsers.

  3. Wähle in der Cookie-Ansicht unter Anwendung/Speicher https://clerk.fuxam.app aus.

  4. 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-mcp

Claude 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_options

  • search_fuxam

  • get_study_plan

  • list_enrolled_courses

  • list_bookable_courses

  • get_learning_unit_details

  • get_module_details

  • get_module_attempts

  • get_exam_details

Stundenplan und Arbeitsaufwand:

  • list_student_appointments

  • list_course_appointments

  • list_course_deadlines

  • list_applicable_excluded_dates

  • list_todos

  • list_pinned_courses

  • get_layer_path

  • check_course_conflicts

Kontoänderungen:

  • book_course

  • unbook_course

  • join_waitlist

  • leave_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-id wird für Buchungen, Wartelisten und Konfliktprüfungen verwendet;

  • layerId oder layer_id wird für Termine und Fristen verwendet;

  • courseModuleId ist die stabile Modul-ID;

  • moduleVersionId identifiziert eine Curriculum-Version;

  • organizationTermId identifiziert 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 fuxam

FUXAM_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:mcpb

Der 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 tools
book_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 ConflictsA
Read-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 OptionsA
Read-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 DetailsB
Read-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 PathA
Read-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 DetailsA
Read-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 AttemptsA
Read-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 DetailsA
Read-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 PlanA
Read-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 WaitlistA
Destructive

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 DatesA
Read-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 CoursesA
Read-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 AppointmentsA
Read-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 DeadlinesB
Read-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 CoursesA
Read-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 CoursesA
Read-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 AppointmentsC
Read-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-DosA
Read-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 FuxamA
Read-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 CourseA
Destructive

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

    A3.7/5.0

    Scored across 21 tools

    Disambiguation5/5

    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.

    Naming Consistency4/5

    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.

    Tool Count4/5

    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.

    Completeness4/5

    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

    ActivityNo data
    ResponsivenessSyncing

    Related MCP Connectors

    Related MCP Servers