Skip to main content
Glama
fuxam-student-mcp

fuxam-student-mcp

Fuxam Student MCP

Codex, Claude 및 기타 로컬 MCP 클라이언트를 사용하여 Fuxam 모듈, 학습 단위, 진행 상황, 일정 및 학기 옵션을 살펴보세요.

서버는 사용자 컴퓨터에서 실행되며 Fuxam과 직접 통신합니다. 사용자를 대신해 학기를 선택하려고 하지 않고, 에이전트에게 유용한 소스 사실과 조합 가능한 도구를 제공합니다.

에이전트가 설정하도록 하세요

이 프롬프트를 Codex 또는 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.

직접 설치하는 것을 선호하시나요? 아래 수동 단계를 따르세요.

Related MCP server: MCP UJI Academic Server

요구 사항

  • CODE University Fuxam 계정

  • 명령줄 설치를 위한 Node.js 26 이상

  • Codex, Claude Code 또는 Claude Desktop

Fuxam 세션 쿠키 가져오기

Fuxam의 단기 세션 토큰은 Clerk __client 쿠키에서 갱신됩니다.

  1. 브라우저에서 fuxam.app에 로그인합니다.

  2. 브라우저 개발자 도구를 엽니다.

  3. 애플리케이션/저장소 쿠키 보기에서 https://clerk.fuxam.app을 선택합니다.

  4. __client 쿠키의 값을 복사합니다.

이 값은 비밀번호처럼 취급하세요. 채팅에 붙여넣거나, 커밋하거나, 스크린샷에 포함하지 마세요.

설치

ChatGPT/Codex 앱 및 Codex CLI

설치된 ChatGPT/Codex 앱과 Codex CLI는 로컬 Codex MCP 구성을 공유합니다:

codex mcp add fuxam \
  --env FUXAM_CLERK_CLIENT='<your __client cookie>' \
  -- npx -y fuxam-student-mcp

서버를 추가한 후 새 Codex 작업을 여세요.

Claude Code

claude mcp add --scope user \
  -e FUXAM_CLERK_CLIENT='<your __client cookie>' \
  fuxam -- npx -y fuxam-student-mcp

Claude Desktop

해당 GitHub 릴리스에서 .mcpb 파일을 다운로드하고, Claude Desktop으로 열고, 메시지가 표시되면 Clerk 쿠키를 붙여넣으세요. 이 번들은 동일한 MCP를 로컬에서 실행하며 쿠키를 민감한 구성으로 표시합니다.

기타 로컬 MCP 클라이언트

이 실행 파일과 환경 변수로 stdio 서버를 구성하세요:

{
  "command": "npx",
  "args": ["-y", "fuxam-student-mcp"],
  "env": {
    "FUXAM_CLERK_CLIENT": "<your __client cookie>"
  }
}

외부 구성 키는 클라이언트마다 다릅니다. 클라이언트의 일반적인 로컬 stdio MCP 설정을 사용하세요.

사용해 보기

좋은 첫 프롬프트 예시:

  • "현재 선택할 수 있는 모듈 카테고리와 학습 단위를 보여줘."

  • "요구 사항, 진행 상황, 강사, 날짜, 학습량을 포함해 이 세 모듈을 비교하는 데 도움을 줘."

  • "내 학습 계획과 현재 진행 상황을 확인한 다음, 현실적인 학기를 구성하는 데 도움을 줘."

  • "이 제안된 학습 단위 집합에 일정 충돌이 있는지 확인해 줘."

  • "다음 달에 마감 기한과 약속이 무엇이 있지?"

에이전트는 카테고리/태그 또는 텍스트로 탐색하고, 모듈과 학습 단위를 일괄 검사하고, 결과를 진행 상황과 비교하고, 제안된 강좌 집합의 충돌을 확인할 수 있습니다.

기능

계획 및 탐색:

  • 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

일정 및 학습량:

  • list_student_appointments

  • list_course_appointments

  • list_course_deadlines

  • list_applicable_excluded_dates

  • list_todos

  • list_pinned_courses

  • get_layer_path

  • check_course_conflicts

계정 변경:

  • book_course

  • unbook_course

  • join_waitlist

  • leave_waitlist

네 가지 계정 변경 도구는 실제 Fuxam 계정에 영향을 미칩니다. MCP 클라이언트에 쓰기 작업으로 표시되며, 각 변경은 결과 Fuxam 상태를 검증합니다. 예약은 먼저 자동으로 충돌 검사를 실행하지 않습니다.

에이전트가 사용하는 방법

개방형 계획의 경우 explore_learning_options와 list_enrolled_courses로 시작하세요. 카테고리나 검색어로 범위를 좁힌 다음, 후보 목록을 get_module_details, get_learning_unit_details, get_module_attempts로 일괄 처리하세요. 장단점을 제시하기 전에 check_course_conflicts로 전체 제안 집합을 확인하세요.

식별자 이름이 중요합니다:

  • course id는 예약, 대기자 명단, 충돌 검사에 사용됩니다;

  • layerId 또는 layer_id는 약속과 마감 기한에 사용됩니다;

  • courseModuleId는 안정적인 모듈 ID입니다;

  • moduleVersionId는 하나의 커리큘럼 버전을 식별합니다;

  • organizationTermId는 학기를 식별합니다.

Fuxam 가져오기 기반 완료 합계는 구체적인 시도 또는 gradedAt 기록보다 뒤처질 수 있습니다. 에이전트는 불일치가 있을 때 구체적인 기록을 우선해야 합니다.

문제 해결

FUXAM_AUTH_REQUIRED

: Fuxam에 다시 로그인하고, 현재 Clerk __client 쿠키를 복사하고, 이전 MCP 항목을 제거한 후 새 값으로 다시 추가하세요.

codex mcp remove fuxam
claude mcp remove --scope user fuxam

FUXAM_UNSUPPORTED_INSTITUTION

: 이 릴리스는 CODE University Fuxam 환경을 지원합니다.

FUXAM_CONTEXT_REQUIRED

: 서버가 하나의 활성 코호트와 학습 프로그램 컨텍스트를 식별할 수 없습니다. 이슈를 열 때 전체 오류를 포함하되, 쿠키, 헤더 또는 원시 Fuxam 응답 데이터는 절대 포함하지 마세요.

부분 결과

: 일부 선별된 읽기는 여러 Fuxam 섹션을 결합합니다. 선택적 업스트림 섹션을 일시적으로 사용할 수 없는 경우, MCP는 검색할 수 있는 섹션을 partial: true로 반환하고 재시도할 수 있는 항목을 식별합니다.

개인정보 보호

버전 0.1은 원격 측정을 수집하지 않습니다. 로컬 MCP에서 Fuxam 및 Clerk로의 직접 요청을 제외하고, Fuxam 자격 증명과 학생 데이터는 사용자 컴퓨터에 남아 있습니다. 도구 결과는 선택한 MCP 클라이언트로 전송되며, 해당 클라이언트의 자체 데이터 통제가 적용됩니다.

라이선스

비상업적 사용은 PolyForm Noncommercial License 1.0.0에 따라 라이선스가 부여됩니다. 상업적 사용은 Maximilian Spitzer로부터 별도의 서면 라이선스가 필요합니다. GitHub을 통해 작성자에게 문의하세요.

개발

npm ci
npm run check
npm run test:package
npm run package:mcpb

패키지 스모크 테스트는 생성된 npm tarball을 깨끗한 임시 디렉터리에 설치하고, stdio를 통해 MCP를 협상하고, 도구를 나열하고, 자격 증명 없는 시작 동작을 검증합니다. 테스트는 실제 학생 자격 증명을 사용하거나 Fuxam 변경을 수행하지 않습니다.

프로젝트 상태

이것은 CODE University와 Fuxam의 허가를 받아 게시된 비공식 학생 제작 클라이언트입니다. Fuxam은 학업 기록, 요구 사항, 가용성 및 계정 상태의 진실의 원천으로 남아 있습니다.

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