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セッションCookieを取得する
Fuxamの短命セッショントークンは、Clerkの__client Cookieから更新されます。
ブラウザでfuxam.appにサインインします。
ブラウザの開発者ツールを開きます。
アプリケーション/ストレージのCookieビューで、
https://clerk.fuxam.appを選択します。__clientCookieの値をコピーします。
この値はパスワードのように扱ってください。チャットに貼り付けたり、コミットしたり、スクリーンショットに含めたりしないでください。
インストール
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 Releaseから.mcpbファイルをダウンロードし、Claude Desktopで開き、プロンプトが表示されたらClerk Cookieを貼り付けます。バンドルは同じMCPをローカルで実行し、Cookieを機密設定としてマークします。
その他のローカルMCPクライアント
この実行可能ファイルと環境変数でstdioサーバーを設定します:
{
"command": "npx",
"args": ["-y", "fuxam-student-mcp"],
"env": {
"FUXAM_CLERK_CLIENT": "<your __client cookie>"
}
}外側の設定キーはクライアントによって異なります。クライアントの通常のローカルstdio MCP設定を使用してください。
試してみる
おすすめの最初のプロンプト:
「現在選択できるモジュールカテゴリと学習ユニットを表示して。」
「要件、進捗状況、講師、日程、作業量を含めて、これら3つのモジュールの比較を手伝って。」
「学習計画と現在の進捗状況を見て、現実的な学期を組み立てるのを手伝って。」
「この提案された学習ユニットのセットにスケジュールの競合があるか確認して。」
「今後1ヶ月の締め切りと予定は何がある?」
エージェントはカテゴリ/タグまたはテキストで閲覧し、モジュールと学習ユニットを一括検査し、結果を進捗状況と比較し、提案されたコースセットの競合を確認できます。
機能
計画と発見:
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
4つのアカウント変更ツールは、実際のFuxamアカウントに影響を与えます。これらはMCPクライアントの書き込み操作としてマークされ、各変更は結果のFuxam状態を検証します。予約は事前に競合チェックを静かに実行しません。
エージェントの使用方法
オープンエンドの計画には、explore_learning_optionsとlist_enrolled_coursesから始めてください。カテゴリまたは検索クエリで絞り込み、その後get_module_details、get_learning_unit_details、get_module_attemptsでショートリストを一括処理します。トレードオフを提示する前に、check_course_conflictsで提案された完全なセットを確認してください。
識別子名が重要です:
コース
idは予約、ウェイトリスト、競合チェックに使用されます;layerIdまたはlayer_idは予定と締め切りに使用されます;courseModuleIdは安定したモジュールIDです;moduleVersionIdはカリキュラムのバージョンを識別します;organizationTermIdは学期を識別します。
Fuxamのインポート由来の完了合計は、具体的な試行またはgradedAtレコードより遅れることがあります。エージェントは不一致がある場合、具体的なレコードを優先してください。
トラブルシューティング
FUXAM_AUTH_REQUIRED
: Fuxamに再度サインインし、現在のClerk __client Cookieをコピーし、古いMCPエントリを削除して、新しい値で再度追加してください。
codex mcp remove fuxam
claude mcp remove --scope user fuxamFUXAM_UNSUPPORTED_INSTITUTION
: このリリースはCODE University Fuxam環境をサポートしています。
FUXAM_CONTEXT_REQUIRED
: サーバーが1つのアクティブなコホートと学習プログラムのコンテキストを識別できませんでした。問題を開くときは完全なエラーを含めてください。ただし、Cookie、ヘッダー、または生のFuxam応答データは絶対に含めないでください。
部分的な結果
: 一部のキュレーションされた読み取りは、複数のFuxamセクションを組み合わせます。オプションの上流セクションが一時的に利用できない場合、MCPは取得できたセクションをpartial: trueで返し、再試行できる内容を特定します。
プライバシー
バージョン0.1はテレメトリを収集しません。Fuxam資格情報と学生データは、ローカルMCPからFuxamとClerkへの直接リクエストを除き、お使いのコンピューター上に残ります。ツールの結果は、選択した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.-