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の短命セッショントークンは、Clerkの__client Cookieから更新されます。

  1. ブラウザでfuxam.appにサインインします。

  2. ブラウザの開発者ツールを開きます。

  3. アプリケーション/ストレージのCookieビューで、https://clerk.fuxam.appを選択します。

  4. __client Cookieの値をコピーします。

この値はパスワードのように扱ってください。チャットに貼り付けたり、コミットしたり、スクリーンショットに含めたりしないでください。

インストール

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 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_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

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 fuxam

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