Fuxam 学生 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 设置。

试试看

适合首次尝试的提示词包括：

• “向我展示我目前可以选择的模块类别和学习单元。”

• “帮我比较这三个模块，包括要求、进度、讲师、日期和工作量。”

• “查看我的学习计划和当前进度，然后帮我制定一个切实可行的学期计划。”

• “检查这组提议的学习单元是否存在时间冲突。”

• “下个月我有哪些截止日期和预约？”

代理可以按类别/标签或文本浏览，批量检查模块和学习单元，将结果与你的进度进行比较，并检查提议的课程集是否存在冲突。

功能

规划与发现：

• 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 cookie，删除旧的 MCP 条目，然后使用新值重新添加。

codex mcp remove fuxam
claude mcp remove --scope user fuxam

FUXAM_UNSUPPORTED_INSTITUTION

: 此版本支持 CODE University Fuxam 环境。

FUXAM_CONTEXT_REQUIRED

: 服务器无法识别一个有效的群组和学习项目上下文。在提交 issue 时请包含完整错误，但切勿包含你的 cookie、请求头或 Fuxam 原始响应数据。

部分结果

: 某些精选读取会组合多个 Fuxam 部分。如果可选的上游部分暂时不可用，MCP 会返回其能够检索到的部分，并带有 partial: true，同时指出哪些可以重试。

隐私

0.1 版本不收集任何遥测数据。你的 Fuxam 凭据和学生数据保留在你的计算机上，本地 MCP 直接向 Fuxam 和 Clerk 发出的请求除外。工具结果会发送给你选择的 MCP 客户端，并受该客户端自身数据控制策略的约束。

许可证

非商业使用根据 PolyForm 非商业许可证 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 仍然是学术记录、要求、可用性和账户状态的权威来源。