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セッションCookieを取得する

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は学術記録、要件、可用性、アカウント状態の情報源であり続けます。