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

Получите свой сессионный cookie 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

Скачайте файл .mcpb из соответствующего релиза GitHub, откройте его в 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 перед представлением компромиссов.

Имена идентификаторов имеют значение:

• 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

: Сервер не смог определить один активный контекст когорты и учебной программы. Включите полную ошибку при открытии issue, но никогда не включайте свои куки, заголовки или необработанные данные ответа Fuxam.

Частичные результаты

: Некоторые курируемые чтения объединяют несколько разделов Fuxam. Если необязательный вышестоящий раздел временно недоступен, MCP возвращает разделы, которые удалось получить, с partial: true и указывает, что можно повторить.

Конфиденциальность

Версия 0.1 не собирает телеметрию. Ваши учётные данные Fuxam и данные студента остаются на вашем компьютере, за исключением прямых запросов от локального MCP к Fuxam и Clerk. Результаты инструментов отправляются выбранному вами MCP-клиенту и подчиняются его собственным правилам обработки данных.

Лицензия

Некоммерческое использование лицензируется в соответствии с PolyForm Noncommercial License 1.0.0. Коммерческое использование требует отдельной письменной лицензии от Максимилиана Шпитцера; свяжитесь с автором через GitHub.

Разработка

npm ci
npm run check
npm run test:package
npm run package:mcpb

Смоук-тест пакета устанавливает сгенерированный npm-тарболл в чистую временную директорию, ведёт переговоры MCP через stdio, перечисляет его инструменты и проверяет поведение запуска без учётных данных. Тесты никогда не используют реальные учётные данные студента и не выполняют мутаций Fuxam.

Статус проекта

Это неофициальный клиент, созданный студентом, опубликован с разрешения CODE University и Fuxam. Fuxam остаётся источником истины для академических записей, требований, доступности и состояния аккаунта.