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.

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

요구 사항

• 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은 학업 기록, 요구 사항, 가용성 및 계정 상태의 진실의 원천으로 남아 있습니다.