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 쿠키에서 갱신됩니다.
브라우저에서 fuxam.app에 로그인합니다.
브라우저 개발자 도구를 엽니다.
애플리케이션/저장소 쿠키 보기에서
https://clerk.fuxam.app을 선택합니다.__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-mcpClaude 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_optionssearch_fuxamget_study_planlist_enrolled_courseslist_bookable_coursesget_learning_unit_detailsget_module_detailsget_module_attemptsget_exam_details
일정 및 학습량:
list_student_appointmentslist_course_appointmentslist_course_deadlineslist_applicable_excluded_dateslist_todoslist_pinned_coursesget_layer_pathcheck_course_conflicts
계정 변경:
book_courseunbook_coursejoin_waitlistleave_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 fuxamFUXAM_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 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.-