安装

npx brightspace-mcp-server setup

适合谁

如果你已经有学校的 D2L Brightspace 账号，希望在支持 MCP 的对话环境里按需查看成绩、作业、教学大纲和课程内容，而不是反复打开学习平台网页，这个服务对口。官方说明它把 AI 接到 Brightspace，用来按需拉取这些课程信息。

学校侧写的是能用于任何学校，但没有给出学校清单、例外名单，也没有说明哪些院系功能会被关掉。你需要自己确认学校登录页可以打开，并且账号能进入课程。

官方点名可用于 Claude Desktop、Claude Code、Cursor、ChatGPT Desktop、Windsurf。如果你的环境不在这份名单里，原文没有另给接入步骤，就不要自行补客户端配置。

不适合需要在 Brightspace 里交作业、发帖或改任何平台数据的人。官方写明这是只读服务，不会提交、发布或更改任何内容。

先决条件：本机已安装能运行 npx 的环境，并且你能打开自己学校的真实 Brightspace 登录页。用户名和密码只会打进学校登录页，不会打到别处；完成后保存在本机 ~/.brightspace-mcp/config.json，仅当前用户可读（mode 0600）。

只走这一条官方安装路径。在终端执行：

npx brightspace-mcp-server setup

配置位置就是这条 setup 命令写入的本机文件 ~/.brightspace-mcp/config.json。第一次尝试直接运行这条官方命令，不要改成未写出的安装器，也不要编造未写出的工具名去试读成绩。

成功信号：setup 正常结束，且本机出现 ~/.brightspace-mcp/config.json、权限为当前用户可读。此后服务按官方说明保持只读，不会替你提交或改动 Brightspace 里的任何内容。

案例一：按需查看成绩。官方能力是连接 Brightspace 后按需拉取成绩。可见说明只写到“拉取成绩”，没有给出工具名、参数或返回字段。能确认的是：这属于只读读取，成功时应能看到成绩相关信息，且不会在平台上提交或改动任何内容。若当前客户端没有列出成绩相关调用，就停在已写出的能力边界。

案例二：按需查看作业、教学大纲与课程内容。官方同一句话把作业、教学大纲和课程内容列为可按需拉取的信息。同样没有写出工具名、过滤条件或输出样例。提问应限制在这些只读材料；成功时能读到对应课程信息，失败时只能说明官方尚未给出更细的调用格式，不要自行补参数。

这是只读服务，不会提交、发帖或更改 Brightspace 中的任何内容。只读不等于没有风险：本机仍会保存学校账号，客户端仍会联网读取课程数据。

凭据只留在本机 ~/.brightspace-mcp/config.json，权限为 0600；登录信息只打进学校真实登录页。官方没有写出删除该文件后的撤销步骤，也没有写出具体工具名和参数。除 setup 外不要再发明第二条安装命令。