Brightspace

io.github.RohanMuppav3.10.2更新於 Oct 3, 2026

D2L Brightspace MCP server: grades, due dates, assignments, announcements and files. Any school.

已驗證STDIO僅桌面Productivity & WorkflowKnowledge & Memory

概覽

AI 產生的概覽

讓助理讀取學生在 D2L Brightspace 上的課程資訊：成績、截止日期、作業、公告和檔案。

功能
把 AI 助理連接到學校的 D2L Brightspace 帳號，用來回答課程相關問題。涵蓋成績、截止日期、作業與評分規準、測驗、公告、課程內容與檔案、人員、討論、授課影片和行事曆。也提供現成提示詞，例如每週簡報、成績審查、讀書計畫和課程摘要。README 說明它只讀取課程，不會提交、修改或刪除任何內容。
適用情境
適合想詢問有哪些作業到期、成績如何或有哪些公告的學生，也適合需要查看繳交情況和回饋的教師或助教。如果你的學校使用 D2L Brightspace，並希望在 AI 應用程式內取得課程資訊，可以考慮安裝。
執行需求
以 npm 套件（brightspace-mcp-server）透過 stdio 在本機執行，需要 Node.js 20 或更新版本。安裝精靈會詢問學校的 Brightspace 網址、使用者名稱、密碼和雙重驗證方式；密碼存放在作業系統的認證儲存區。選用設定包括 D2L_BASE_URL、D2L_SESSION_DIR、D2L_HEADLESS、D2L_INCLUDE_COURSES、D2L_EXCLUDE_COURSES，以及 D2L_SESSION_COOKIE 或 D2L_ACCESS_TOKEN。僅支援桌面端。
安裝前請注意
安裝精靈會蒐集學校使用者名稱和密碼並存入本機認證儲存區；D2L_SESSION_COOKIE 和 D2L_ACCESS_TOKEN 是替代認證。D2L_REMEMBER_MFA=true 會讓後續登入略過第二因素，不適合共用電腦。此伺服器會讀取課程資料，包括教師查看學生繳交內容，並把這些資料傳送給 AI 應用程式。除非設定 D2L_NO_UPDATE_CHECK，否則會檢查 npm 儲存庫是否有新版本。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Brightspace，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

Brightspace MCP Server

[npm version] [npm downloads] [CI] [License: MIT] [Node >= 20]

By Rohan Muppa, ECE @ Purdue

Lets your AI see your Brightspace classes, so you can just ask:

"What's due this week?" · "Am I passing all my classes?" · "Summarize today's announcements" · "Turn my lecture slides into flashcards"

Works with Claude Desktop, Claude Code, Cursor, ChatGPT Desktop, Windsurf, and any other app that supports MCP (the standard way to plug tools into an AI). It only reads your courses — it never submits, edits, or deletes anything.

[Architecture diagram]

Get started in 3 steps

  1. Install Node.js (version 20 or newer) if you don't have it. Download, run the installer, done.

  2. Open a terminal and run the setup:

    bash
    npx -y brightspace-mcp-server@latest setup

    It asks for your school's Brightspace address, your username and password, and how you normally do two-factor sign-in (phone approval, authenticator code, or a browser window). Your password goes into your computer's own password store (Keychain on Mac, Credential Manager on Windows), never into a file. At the end it connects itself to Claude Desktop, Cursor, Codex, or Claude Code if you have them.

    On a Mac: when Keychain asks whether node may use the saved Brightspace password, choose Always Allow, not just Allow. That lets later sign-ins (the auth command and questions from your AI app) read it without asking again.

  3. Restart your AI app and ask it something — the first question signs you in. If your phone asks you to approve a sign-in, approve it and ask again.

At one of these schools, add the flag and skip typing the address: --purdue, --suny, --western, --tudelft, --cuny, --leiden, --mcgill, --ngeeann, --javeriana.

Rather have the AI install it for you? Paste this into Claude Code, Cursor, Windsurf, Copilot, or Codex:

Install brightspace-mcp-server for me by followinghttps://github.com/RohanMuppa/brightspace-mcp-server/blob/main/LLMs.md(use --purdue at Purdue, --suny at SUNY, --tudelft at TU Delft, --cuny at CUNY, --leiden at Leiden, --mcgill at McGill, --ngeeann at Ngee Ann Polytechnic, or --javeriana at Javeriana Cali).

Using a different AI app? Add the command npx -y brightspace-mcp-server@latest to its MCP settings (on Windows: cmd /c npx -y brightspace-mcp-server@latest). Exact steps for each app: docs/troubleshooting.md.

Does my school work?

If your school uses D2L Brightspace, yes. These have automatic sign-in built in:

SchoolSign-inFlag
PurdueMicrosoft (phone approval, authenticator code, or browser)--purdue
SUNYShared site with a campus picker--suny
Western UniversityMicrosoft--western
TU DelftNetID (no two-factor)--tudelft
CUNYCUNY Login, authenticator code each time--cuny
Leiden UniversitySURFconext → Microsoft--leiden
McGill UniversityMicrosoft Entra--mcgill
Javeriana CaliOneGate (password + authenticator code)--javeriana
Ngee Ann PolytechnicMicrosoft Entra--ngeeann
Any other D2L schoolPaste your Brightspace address; if the login page isn't recognized, a browser window opens so you can sign in by handnone

School-specific quirks: docs/sign-in.md.

Things to ask

AboutTry
Grades"Am I passing all my classes?" · "Compare my grades across courses"
Due dates"What's due in the next 48 hours?" · "Build me a study schedule for the week"
Assignments and rubrics"What does the lab 4 spec actually ask for?" · "Why did I lose points on the analysis criterion?"
Quizzes and exams"Which quizzes close this week?" · "Is there a midterm in the gradebook that isn't on my assignments list?"
Announcements"Did any professor post something important today?" · "Read the file attached to today's announcement"
Course content"Find the midterm review slides" · "Download every PDF from Module 5" · "Search this course for office hours" · or just read a file inline instead of saving it
People"Who are the TAs for ECE 264?" · "Who is in my project group?"
Discussions"Summarize the latest posts in the final project thread"
Lecture videos"What did the professor say about pinch-off in Tuesday's recording?" (Kaltura and YouTube)
Calendar"When is my midterm?" · "Is lab cancelled on Thursday?"
For instructors and TAs"Which students haven't submitted Lab 4 yet?" · "What feedback did I leave on this student's homework?" · "Download that student's submitted PDF" (students see a clear "instructor access required" note)

Prompts

Apps with a prompt picker (like Claude Desktop) also offer four ready-made prompts, so you can start from one click instead of typing a question:

PromptArgumentsWhat it asks for
weekly_briefing—A 7-day rollup of what's due, what's new, and what changed in your grades, across every course
grade_auditcourseId (optional)Analyzes grades for one course, or all of them, and flags missing or low-scoring items
study_plannerdaysAhead (optional, default 7)Plans study time from upcoming due dates and calendar events
course_summarycourseId (required)Syllabus, content outline, assignments, and grades for one course

Settings you might want

All optional, set in your AI app's MCP env config or your shell. The full list is in LLMs.md.

SettingWhat it does
D2L_REMEMBER_MFA=trueTick Microsoft's "Don't ask again" box so later sign-ins skip the second factor (off by default; not for shared computers)
D2L_HEADLESS=falseShow the browser window during sign-in, for MFA methods that need a click
D2L_DUO_PASSCODE=1On Duo, type a passcode instead of waiting for a push
D2L_SESSION_COOKIE / D2L_ACCESS_TOKENSkip the browser entirely with a pasted cookie or token (how)
D2L_INCLUDE_COURSES / D2L_EXCLUDE_COURSESLimit which courses the AI sees, by course id
D2L_ACTIVE_ONLY=falseInclude courses whose enrollment has ended
D2L_NO_UPDATE_CHECK=1Turn off the new-version notice

When it asks you to sign in

There's no separate login — asking a question signs you in, and it stays signed in on its own most days. When your school wants two-factor again, the number to approve shows up right in the answer; approve it on your phone and ask again. If your AI client shows tool progress messages, the number appears while the question is still running instead, and approving within 45 seconds (less if sign-in was slow to reach two-factor) finishes the original answer without asking again. If it ever gets stuck, run this in a terminal:

bash
npx -y brightspace-mcp-server@latest auth

On a Mac, sign-in first reads your saved password from Keychain. If you picked a one-time Allow at the Keychain prompt, a later sign-in from your AI app or another terminal can fail or hang waiting for an approval nobody sees; pick Always Allow instead. That permission only lets the local Brightspace server read its own saved sign-in password, nothing else in your Keychain.

How often you're asked is up to your school, not this tool. Everything else about sign-in — Duo, authenticator codes, visible-browser mode, and running without a browser at all (Docker, WSL, hardware keys) — is in docs/sign-in.md.

Something not working?

  • Run npx -y brightspace-mcp-server@latest doctor first — it checks your Node version, saved setup, credential store, Brightspace connectivity, saved sign-in, and installed version, and tells you exactly what to fix.
  • Authentication failed: The native credential store is locked or unavailable. Your password store is locked or hasn't let this server read the saved password. Unlock it (on a Mac, log in or unlock Keychain Access), then run npx -y brightspace-mcp-server@latest auth again, or setup if that still fails, and choose Always Allow when Keychain asks.
  • It works in the terminal but not in the app: the app starts it separately and may not see your password store yet — see docs/troubleshooting.md.
  • Which version do I have? Ask your AI "which version of the Brightspace server am I running?"
  • Still stuck? Open an issue and paste what the terminal printed.

For developers

Tool reference, response fields, and environment variables: LLMs.md. What's safe to build against: STABILITY.md. Licensed under the MIT License.

來源：README.md，提交 21aa129

工具

0
工具後設資料尚未被收錄。

版本歷史

1
  1. v3.10.2最新Oct 3, 2026