使用说明

Brightspace MCP服务器

通过优素福·阿拉米卡尔顿大学

将您的Brightspace连接到AI。直接在聊天中向Claude、ChatGPT、Cursor或Windsurf询问您的成绩、截止日期、公告、课程内容等。

适用于任何使用D2L Brightspace的学校。

我该怎么办？

一旦设置好，你可以问你的人工智能一些事情，比如：

“本周我所有的课程都要交什么？”
“我所有的课都及格了吗？”
“下载我的讲座幻灯片并将其转换为抽认卡”
“根据我即将到来的截止日期为我制定学习计划”
“谁是我课程的助教？”
“今天有教授发什么重要消息吗？”

开始之前

您的计算机上需要安装两件事：

Node.js 18或更新版本 --在此处下载： https://nodejs.org （点击绿色的大“LTS”按钮，运行安装程序，点击下一步完成所有操作）
AI聊天机器人应用程序 --选择一个：
- 克劳德桌面（免费）
- ChatGPT桌面（免费）
- 光标（免费）
- 帆板运动（免费）

安装程序（Mac）

第一步：打开终端

按 命令+空间 在键盘上键入终端，然后按Enter键。将出现一个带有黑色或白色文本屏幕的窗口。这是粘贴命令的地方。

步骤2：安装所有内容

将整个区块复制到下面。返回终端，右键单击并选择粘贴（或按 命令+V).然后点击进入然后等待它完成。可能需要几分钟。

git clone https://github.com/Yxxxxs/Brightspace-mcp-server.git
cd Brightspace-mcp-server
npm install --ignore-scripts
npx playwright install chromium
npm run build
mkdir -p ~/.npm-global && npm config set prefix '~/.npm-global'
npm install -g .
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.zshrc
source ~/.zshrc
chmod +x ~/.npm-global/bin/brightspace-mcp-server ~/.npm-global/bin/brightspace-auth ~/.npm-global/bin/brightspace-setup 2>/dev/null

你会看到一堆文字滚动过去。这很正常。等到你再次看到你的用户名 $ 或 % 标志——这意味着它已经完成了。

如果你看到任何写着“警告”的文字，那很好。只有“错误”才重要。

步骤3：运行安装程序

在同一个终端窗口中，粘贴此内容并按Enter键：

brightspace-mcp-server setup

它会问： “你的Brightspace URL是什么？”

键入学校的Brightspace网址。例如：

卡尔顿学生类型： https://brightspace.carleton.ca
其他学校：键入您通常访问Brightspace的任何URL

然后它会要求你 用户名 和密码（您用来登录Brightspace的那些）。

步骤4：身份验证

在同一个终端窗口中，粘贴此内容并按Enter键：

brightspace-mcp-server auth

浏览器窗口将弹出，显示您学校的登录页面。 像往常一样登录 （输入您的用户名、密码，如果您的学校使用它，请批准MFA/Duo）。

登录后，返回终端窗口。等到你看到：

=== Authentication successful! ===

如果你看到了，你就快完成了！

步骤5：连接到您的AI应用程序

选择您正在使用的任何应用程序，并按照这些说明进行操作：

Claude Desktop (click to expand)

打开查找器 （dock中的笑脸图标）
在屏幕顶部的菜单栏中，单击去，然后单击 转到文件夹。..
粘贴此内容并按Enter键：
```
~/Library/Application Support/Claude
```
将打开一个文件夹。查找名为的文件 claude_desktop_config.json
- 如果文件存在： 双击它以在TextEdit中打开
- 如果文件不存在： 打开文本编辑（命令+空格，键入文本编辑，按Enter键）。点击格式在菜单栏中，然后选择 制作纯文本

删除文件中的所有内容（如果有的话）并粘贴如下内容：

{
  "mcpServers": {
    "brightspace": {
      "command": "brightspace-mcp-server"
    }
  }
}

保存文件(命令+S).如果您创建了一个新文件，请将其另存为 claude_desktop_config.json 在那个克劳德文件夹里。确保它不会另存为 .txt --如果是，请重命名它以删除 .txt 部分。
完全退出克劳德桌面： 点击 克劳德 在顶部菜单栏中，然后 退出克劳德。（不要只点击红色的X——这并不能完全关闭它。）
再次打开克劳德桌面。
试着问： “我的Brightspace课程是什么？”

如果克劳德回复你的课程清单，你就准备好了！

ChatGPT Desktop (click to expand)

打开ChatGPT桌面应用程序
点击 ChatGPT 在顶部菜单栏中，然后单击设置
点击工具左侧
点击 添加MCP工具
点击 “手动添加”

粘贴此内容：

{
  "command": "brightspace-mcp-server"
}

点击保存或添加
完全退出ChatGPT： 点击 ChatGPT 在顶部菜单栏中，然后 退出ChatGPT
再次打开ChatGPT
试着问： “我的Brightspace课程是什么？”

Cursor (click to expand)

打开查找器 （dock中的笑脸图标）
在顶部的菜单栏中，单击去那么 转到文件夹。..
粘贴此内容并按Enter键：
```
~/.cursor
```
查找名为的文件 mcp.json
- 如果存在： 双击以在TextEdit中打开
- 如果它不存在： 打开文本编辑，单击格式 > 制作纯文本，并创建新文件

删除所有内容并粘贴如下内容：

{
  "mcpServers": {
    "brightspace": {
      "command": "brightspace-mcp-server"
    }
  }
}

将文件另存为 mcp.json 在 .cursor 文件夹
完全退出游标 并重新打开它
试着问： “我的Brightspace课程是什么？”

Windsurf (click to expand)

打开查找器 （dock中的笑脸图标）
在顶部的菜单栏中，单击去那么 转到文件夹。..
粘贴此内容并按Enter键：
```
~/.windsurf
```
查找名为的文件 mcp.json
- 如果存在： 双击以在TextEdit中打开
- 如果它不存在： 打开文本编辑，单击格式 > 制作纯文本，并创建新文件

删除所有内容并粘贴如下内容：

{
  "mcpServers": {
    "brightspace": {
      "command": "brightspace-mcp-server"
    }
  }
}

将文件另存为 mcp.json 在 .windsurf 文件夹
完全退出Windsurf 并重新打开它
试着问： “我的Brightspace课程是什么？”

安装程序（Windows）

步骤1：打开命令提示符

按下 Windows键 在键盘上键入命令，然后按Enter键。

步骤2：安装所有内容

将这些行复制并粘贴到命令提示符中 一次一行，每次之后按Enter键：

git clone https://github.com/Yxxxxs/Brightspace-mcp-server.git

cd Brightspace-mcp-server

npm install --ignore-scripts

npx playwright install chromium

npm run build

npm install -g .

步骤3：运行安装程序

brightspace-mcp-server setup

当被询问时，请输入学校的Brightspace URL（例如。 https://brightspace.carleton.ca)，然后是您的用户名和密码。

步骤4：身份验证

brightspace-mcp-server auth

浏览器将打开。登录Brightspace。等待命令提示符中的“身份验证成功！”。

步骤5：连接到您的AI应用程序

选择您正在使用的任何应用程序：

Claude Desktop - Windows (click to expand)

按 Windows键+R 在键盘上
粘贴此内容并按Enter键：
```
%APPDATA%\Claude
```
将打开一个文件夹。寻找 claude_desktop_config.json
- 如果存在： 右键单击它>打开方式>记事本
- 如果它不存在： 在文件夹中单击鼠标右键>新建>文本文档。命名它 claude_desktop_config.json （确保文件扩展名在Windows中可见，这样它就不会变成 .json.txt)

删除所有内容并粘贴：

{
  "mcpServers": {
    "brightspace": {
      "command": "cmd",
      "args": ["/c", "brightspace-mcp-server"]
    }
  }
}

保存并关闭
完全退出克劳德桌面 （右键单击时钟附近系统托盘中的图标，然后选择退出）
重新打开克劳德桌面
问： “我的Brightspace课程是什么？”

ChatGPT Desktop - Windows (click to expand)

打开ChatGPT桌面应用程序
单击菜单（三行或齿轮图标），然后设置
点击工具
点击 添加MCP工具 > “手动添加”

粘贴此内容：

{
  "command": "cmd",
  "args": ["/c", "brightspace-mcp-server"]
}

点击保存或添加
完全退出ChatGPT并重新打开它
问： “我的Brightspace课程是什么？”

Cursor - Windows (click to expand)

按 Windows键+R
粘贴此内容并按Enter键：
```
%USERPROFILE%\.cursor
```
打开或创建 mcp.json 在记事本中

粘贴：

{
  "mcpServers": {
    "brightspace": {
      "command": "cmd",
      "args": ["/c", "brightspace-mcp-server"]
    }
  }
}

保存并关闭
完全退出Cursor并重新打开它
问： “我的Brightspace课程是什么？”

Windsurf - Windows (click to expand)

按 Windows键+R
粘贴此内容并按Enter键：
```
%USERPROFILE%\.windsurf
```
打开或创建 mcp.json 在记事本中

粘贴：

{
  "mcpServers": {
    "brightspace": {
      "command": "cmd",
      "args": ["/c", "brightspace-mcp-server"]
    }
  }
}

保存并关闭
完全退出Windsurf并重新打开它
问： “我的Brightspace课程是什么？”

会话已过期？

如果您的AI无法访问Brightspace，请打开终端（Mac）或命令提示符（Windows）并运行：

brightspace-mcp-server auth

在打开的浏览器中重新登录。然后退出并重新打开您的AI应用程序。

故障排除

“找不到命令” --打开终端并运行： echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.zshrc && source ~/.zshrc

“权限被拒绝” --打开终端并运行： chmod +x ~/.npm-global/bin/brightspace-mcp-server ~/.npm-global/bin/brightspace-auth ~/.npm-global/bin/brightspace-setup

AI对Brightspace没有回应 --确保您完全退出AI应用程序（而不仅仅是关闭窗口）并重新打开它。

“未通过身份验证” --快跑 brightspace-mcp-server auth 在终端中重新登录。

需要重新开始 --快跑 brightspace-mcp-server setup 在终端。

身份验证期间浏览器崩溃 --快跑 rm -rf ~/.d2l-session 在终端中清除旧数据，然后尝试 brightspace-mcp-server auth 再一次。

确认工作

卡尔顿大学（安大略省渥太华）

如果你在学校能做到这一点，打开一个问题将其添加到此列表中。

安全

您的凭据仅保留在您的计算机上
会话令牌已加密
所有流量都使用HTTPS
除了你学校的登录页面，什么都不会发送到任何地方

根据AGPL-3.0许可。看许可证了解详情。

使用说明

Brightspace MCP服务器

我该怎么办？

开始之前

安装程序（Mac）

第一步：打开终端

步骤2：安装所有内容

步骤3：运行安装程序

步骤4：身份验证

步骤5：连接到您的AI应用程序

安装程序（Windows）

步骤1：打开命令提示符

步骤2：安装所有内容

步骤3：运行安装程序

步骤4：身份验证

步骤5：连接到您的AI应用程序

会话已过期？

故障排除

确认工作

安全

相关 MCP

小红书MCP服务

Figma MCP集成工具

MCP 协议测试服务器

Flomo笔记服务

Unity编辑器AI集成插件

科学研究的开源MCP服务器