brightspace-d2l-mcp

Brightspace D2L MCP 服务

将 D2L Brightspace 连接到 Claude、ChatGPT、Cursor 和 Copilot。
它知道你已经提交了什么，因此只会显示真正还需要完成的内容。

一条命令。像往常一样登录。不存储密码。

brightspace-mcp.netlify.app

一个 MCP（模型上下文协议）服务，为 AI 助手和 Agent 提供对 Brightspace 课程的只读访问权限：包括截止日期和真实的提交状态、成绩、作业、评分标准、课程内容、公告、讨论和班级名单。凡是使用 D2L Brightspace 的学校都可以使用，包括采用 Microsoft、Duo、Okta 或 Shibboleth 单点登录的学校。

快速开始

你需要安装 Node.js 20 或更高版本以及 Google Chrome 或 Microsoft Edge。

npx brightspace-d2l-mcp setup

就这么简单。设置程序会询问你的学校，打开浏览器供你登录，并连接它找到的所有 AI 应用。 然后向 AI 提问：

“我现在应该做什么？”

刚开始使用？分步设置指南通过每一步的图片带你完成所有操作。 正在使用特定应用？请查看 Claude 和 ChatGPT 指南，或了解与其他 Brightspace MCP 服务的比较。

对比情况

大家通常会在选择 Brightspace MCP 服务前比较几个选项。以下是最常见的三项区别，其他区别请参阅完整对比：

“已发布的工具列表中没有目标成绩工具”表示，截至 2026 年 10 月，我们在各项目公开的 README 和工具列表中都找不到此类工具，并不意味着以后永远不会添加。发现表格有误？请提交 issue，我们会修正。

从 brightspace-mcp-server 切换

如果你正在运行 RohanMuppa 开发的 brightspace-mcp-server，并想试试这个项目，只需更改包名，其他内容保持不变。

在 MCP 配置中，找到 mcpServers 里的 brightspace 条目并替换命令：

{
  "mcpServers": {
    "brightspace": {
      "command": "npx",
      "args": ["-y", "brightspace-d2l-mcp@latest"]
    }
  }
}

在 Windows 上，像现在一样使用 cmd /c 包装启动命令：

{
  "mcpServers": {
    "brightspace": {
      "command": "cmd",
      "args": ["/c", "npx", "-y", "brightspace-d2l-mcp@latest"]
    }
  }
}

然后重启应用。如果你不想编辑文件，可以运行 npx brightspace-d2l-mcp setup：它会询问你的学校，打开浏览器窗口供你登录，并为你写入此条目。你也可以运行 npx brightspace-d2l-mcp config，为任意应用输出准确的 JSON。

哪些内容会保留，哪些不会

想要切换回去？把旧命令放回原处即可。你甚至可以使用两个不同的服务名称并排配置这两个服务，但一个 AI 应用同时连接两个 Brightspace 服务通常会让事情变得更复杂，得不偿失。

第一个服务具备的一些功能在这里没有：它可以将密码保存到电脑的凭据存储中，从而无需打开浏览器窗口即可登录；它还附带了几所指定学校的预设。此服务始终会打开一个普通的浏览器窗口，由你自行登录，这样才能使用单点登录；之后它只会保留你的浏览器会话。

你可以这样提问

它知道你已经提交了什么

大多数工具只能查看截止日期，所以会一直提醒你做已经完成的作业。 此工具会检查每项作业的实际提交状态：

工具

提供 17 个用于 D2L Brightspace 的 MCP 工具。所有工具都只读取 Brightspace 中的信息，不会对其进行任何修改：

提示词和示例问题

支持 MCP 提示词的应用会将它们显示为一键快捷方式或斜杠命令。你不必记住提示词名称：在普通聊天中输入示例问题也能使用，因为每个提示词只是告诉 AI 要调用哪些工具。

适用于任何 Brightspace 学校

每所学校的登录方式都不同：Microsoft、ADFS、Duo、Shibboleth、Okta、Google、校区选择器或 Brightspace 自带的表单。 无需猜测学校的登录方式，设置时会打开一个普通浏览器窗口，让你像平时一样登录，包括输入短信验证码和使用身份验证器应用。

登录后，它会在后台静静保持登录状态。如果学校要求你重新登录，浏览器窗口便会自动弹出，并在你完成登录后自行关闭。

我的学校能用吗？

如果你的学校使用 D2L Brightspace，就可以。设置时会打开一个普通浏览器窗口，因此支持任何登录方式，包括 Microsoft、Duo、Okta 和 Shibboleth。

兼容你的 AI 应用或 Agent

设置后自动连接： Claude Desktop · Claude Code · Cursor · VS Code（GitHub Copilot）· Windsurf · OpenAI Codex · Gemini CLI · Cline · Roo Code · OpenCode · Zed · LM Studio · Kiro

只需复制粘贴即可使用： ChatGPT（开发者模式）· Continue · Goose · JetBrains AI Assistant · Warp · Amp · Msty · Jan · AnythingLLM

Agent 框架： OpenAI Agents SDK · Claude Agent SDK · LangChain / LangGraph · Vercel AI SDK · Mastra · CrewAI · Pydantic AI · LlamaIndex

本地应用通过 stdio 运行，ChatGPT 和托管 Agent 通过 streamable HTTP（serve --http）运行。 请参阅 docs/agents.md，了解这些应用各自的复制粘贴式设置方法。

使用你的 AI 安装

将以下内容粘贴到 Claude Code、Cursor、Windsurf、Copilot 或 Codex 中，它会为你完成所有设置。

Install brightspace-d2l-mcp for me by following
https://github.com/AnonymousOnyx22/brightspace-d2l-mcp/blob/main/llms.txt

命令

有新版本时，命令会先询问是否更新。设置 BRIGHTSPACE_NO_UPDATE_CHECK=1 可关闭此功能。

npx brightspace-d2l-mcp setup --school yourschool.brightspace.com   # skip the school question
npx brightspace-d2l-mcp setup --apps claude-desktop,cursor          # only connect these apps
npx brightspace-d2l-mcp setup --skip-login                          # sign in later, on first use
npx brightspace-d2l-mcp setup --yes                                 # accept every default

隐私与安全

• 绝不会获取或存储你的密码。 你会在真实浏览器中，输入学校自己的登录页面。
• 只读。 它无法在 Brightspace 中提交、发布或更改任何内容。所有工具只会发送 GET 请求，API 客户端完全没有写入方法；如果将来添加了此类方法，测试会导致构建失败。请参阅如何强制执行只读限制。
• 仅在本地运行。 所有操作都在你的电脑上运行，并且只与学校的 Brightspace 通信。中间没有服务器，也不会收集分析数据。
• 使用官方 Brightspace API，权限与您在浏览器中的权限相同。
• 你的会话保存在 ~/.brightspace-d2l-mcp/ 中，只有你的用户帐户可以读取。logout 会删除该会话；uninstall 会删除所有内容。

故障排除

遇到问题了？docs/troubleshooting.md 会介绍如何解决应用中没有显示 Brightspace 工具、设置窗口始终不打开，以及单点登录一直失败的问题，并列出每种情况打印的具体消息。首先运行 npx brightspace-d2l-mcp doctor。

{ "excludeCourses": [123456, 789012] }

开发

git clone https://github.com/AnonymousOnyx22/brightspace-d2l-mcp.git
cd brightspace-d2l-mcp
npm install
npm run build
npm test
node build/index.js setup     # connects your AI apps to this local build

工具位于 src/tools/，登录功能位于 src/auth/，配置功能位于 src/cli/。 欢迎提交问题和拉取请求。

更多免费的学生 MCP 服务

全部免费、开源；涉及你的账户时均为只读。访问 brightspacemcp.com/more-mcps 查看完整列表。

许可证

MIT © AnonymousOnyx22

D2L 和 Brightspace 是 D2L Corporation 的商标。本项目与 D2L 无关。