brightspace-mcp-server 1.2.2 → 1.2.4
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +5 -50
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -23,27 +23,14 @@ Works with any school that uses D2L Brightspace, including Purdue, USC, and hund
|
|
|
23
23
|
|
|
24
24
|
**Option 1: Let your AI do it**
|
|
25
25
|
|
|
26
|
+
If you're an LLM/AI agent helping a user with this project, read [LLMs.md](https://github.com/RohanMuppa/brightspace-mcp-server/blob/main/LLMs.md) for a codebase map and command reference.
|
|
27
|
+
|
|
26
28
|
Paste this into Claude Code, Cursor chat, Windsurf, Copilot, Codex, or any AI coding assistant:
|
|
27
29
|
|
|
28
30
|
```
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
1. First, check if Node.js 18+ is installed. If not, tell me how to install it and stop.
|
|
34
|
-
|
|
35
|
-
2. Run the setup wizard to save my Brightspace credentials:
|
|
36
|
-
npx brightspace-mcp-server setup
|
|
37
|
-
(If I'm a Purdue student, use: npx brightspace-mcp-server setup --purdue)
|
|
38
|
-
This will open a browser for login and MFA. Let me complete that before continuing.
|
|
39
|
-
|
|
40
|
-
3. After setup finishes, configure this AI client to use the MCP server.
|
|
41
|
-
The server command is: npx -y brightspace-mcp-server@latest
|
|
42
|
-
Search the internet for how to configure MCP servers in general for
|
|
43
|
-
whatever client I'm using. Every client has a different config format
|
|
44
|
-
and file path. On Windows, npx must be wrapped with cmd /c.
|
|
45
|
-
|
|
46
|
-
4. Tell me to restart this AI client so it picks up the new MCP server.
|
|
31
|
+
Install the brightspace-mcp-server MCP server for me. Read
|
|
32
|
+
https://github.com/RohanMuppa/brightspace-mcp-server/blob/main/LLMs.md
|
|
33
|
+
and follow the install steps there. If I'm at Purdue, use the --purdue preset.
|
|
47
34
|
```
|
|
48
35
|
|
|
49
36
|
**Option 2: Run it yourself**
|
|
@@ -95,38 +82,6 @@ npx brightspace-mcp-server auth
|
|
|
95
82
|
| Discussions | "What are people saying in the final project thread?" · "Summarize the latest discussion posts" |
|
|
96
83
|
| Planning | "Build me a study schedule based on my upcoming due dates" · "Which class needs the most attention right now?" |
|
|
97
84
|
|
|
98
|
-
## Troubleshooting
|
|
99
|
-
|
|
100
|
-
**"Not authenticated"** → Run `npx brightspace-mcp-server auth`
|
|
101
|
-
|
|
102
|
-
**AI client not responding** → Quit and reopen it completely (not just close the window)
|
|
103
|
-
|
|
104
|
-
**Need to redo setup** → Run `npx brightspace-mcp-server setup` again
|
|
105
|
-
|
|
106
|
-
**Config location** → `~/.brightspace-mcp/config.json` (you can edit this directly)
|
|
107
|
-
|
|
108
|
-
**Browser launch times out (Windows)** → Open Task Manager, end all Chromium/Chrome processes, and try again. If it persists, add the Playwright Chromium folder to your antivirus exclusion list.
|
|
109
|
-
|
|
110
|
-
**Auth fails in WSL or Docker** → Chromium dependencies may be missing. Run `npx playwright install-deps chromium` to install them. The server automatically adds `--no-sandbox` for these environments.
|
|
111
|
-
|
|
112
|
-
**Headless login fails (Windows)** → SSO login flows can fail in headless mode on Windows. The default is headed (a browser window opens). If you set `D2L_HEADLESS=true` and auth fails, switch back to headed mode.
|
|
113
|
-
|
|
114
|
-
**Auth hangs or browser won't open**
|
|
115
|
-
|
|
116
|
-
Delete stale session files and retry:
|
|
117
|
-
```bash
|
|
118
|
-
rm -rf ~/.d2l-session/session.json ~/.d2l-session/storage-state.json ~/.d2l-session/browser-data/SingletonLock
|
|
119
|
-
npx brightspace-mcp-server auth
|
|
120
|
-
```
|
|
121
|
-
|
|
122
|
-
**Still running an old version after update**
|
|
123
|
-
|
|
124
|
-
npx caches packages locally. Clear the cache to force a fresh download:
|
|
125
|
-
```bash
|
|
126
|
-
npx clear-npx-cache
|
|
127
|
-
npx brightspace-mcp-server@latest
|
|
128
|
-
```
|
|
129
|
-
|
|
130
85
|
## Security
|
|
131
86
|
|
|
132
87
|
- Credentials stay on your machine at `~/.brightspace-mcp/config.json` (restricted permissions)
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "brightspace-mcp-server",
|
|
3
|
-
"version": "1.2.
|
|
3
|
+
"version": "1.2.4",
|
|
4
4
|
"mcpName": "io.github.rohanmuppa/brightspace",
|
|
5
5
|
"description": "MCP server for Brightspace (D2L). Check grades, due dates, assignments, announcements, syllabus, rosters and more via Claude, ChatGPT, Cursor, Windsurf, or any MCP client.",
|
|
6
6
|
"type": "module",
|