D2L Brightspace MCP服务器
MCP(模型上下文协议)服务器,为AI助手提供与D2L Brightspace LMS交互的工具。
⚠️ 警告! ⚠️
此服务器应 不 以任何方式被用于学术不端行为。 不要使用此MCP服务器在任何任务中作弊,或获得不公平的优势 其他学生。此服务器仅用于使代理能够 更好地了解你的任务安排,并帮助你 _学习_ 的 课程材料。
我不宽恕在任何违反用户大学学术行为准则的活动中使用此服务器。
特性
- 自动SSO身份验证 通过Playwright(处理微软/机构登录)
- 持久会话存储 -登录一次,使用数小时
- 12工具 用于访问作业、成绩、日历、公告、课程内容
- 文件下载 具有自动文本提取功能(docx、txt等)
- LLM优化响应 -干净、令牌高效的输出
安装
npm install -g d2l-mcp-server这将自动安装Chromium以实现浏览器自动化。
设置
1.首次认证
d2l-mcp-auth这将打开一个浏览器窗口,您可以在其中登录Brightspace。您的会话已保存到 ~/.d2l-session/.
2.配置克劳德桌面
添加到 ~/Library/Application Support/Claude/claude_desktop_config.json (macOS)或 %APPDATA%\Claude\claude_desktop_config.json (Windows):
{
"mcpServers": {
"d2l": {
"command": "d2l-mcp",
"env": {
"D2L_HOST": "learn.ul.ie",
"D2L_COURSE_ID": "68929"
}
}
}
}可用工具
作业
| 工具 | 说明 |
|---|---|
get_assignments | 列出所有作业,并注明截止日期和说明 |
get_assignment | 获取特定任务的完整详细信息 |
get_assignment_submissions | 获取您的提交、成绩和反馈 |
课程内容
| 工具 | 说明 |
|---|---|
get_course_content | 获取完整的课程大纲/结构 |
get_course_topic | 获取特定主题/讲座的详细信息 |
get_course_modules | 获取课程的主要部分/模块 |
get_course_module | 获取特定模块中的内容 |
成绩和日历
| 工具 | 说明 |
|---|---|
get_my_grades | 通过分数和反馈获得所有成绩 |
get_upcoming_due_dates | 获取日历事件和截止日期 |
其他
| 工具 | 说明 |
|---|---|
get_announcements | 从讲师那里获取课程公告 |
get_my_courses | 列出您注册的所有课程 |
download_file | 从课程文件中下载和提取内容 |
示例提示
一旦连接到克劳德,你可以问这样的问题:
- “本周有什么作业要交?”
- “显示我的成绩”
- “发布了哪些公告?”
- “下载周报模板”
- “这门课的教学大纲是什么?”
环境变量
| 变量 | 描述 | 默认值 |
|---|---|---|
D2L_HOST | 您的Brightspace主机名 | learn.ul.ie |
D2L_COURSE_ID | 默认课程ID(可选) | 无 |
设置 D2L_COURSE_ID 允许您在工具调用中省略课程ID。
会话管理
- 令牌到期:身份验证令牌将在约1小时后过期,但会使用保存的浏览器会话自动刷新
- 会话到期:浏览器会话在大约24小时不活动后过期
- 重新验证:运行
d2l-mcp-auth如果您的会话到期
发展
# Run tests
npm test
# Run integration tests (requires auth)
npm run test:integration
# Watch mode
npm run test:watch许可证
麻省理工学院
