Avenue MCP

A2L MCP——人工智能助理的学习之路

一个MCP（模型上下文协议）服务器，允许AI助手访问麦克马斯特的学习大道（D2L Brightspace）。向你的人工智能询问作业、成绩、截止日期、课程内容等。

学术诚信通知：此工具仅用于个人生产力。请勿将其用于任何违反麦克马斯特学术诚信政策的活动。

你能做什么

• 作业 --列出作业、查看详细信息、检查提交和反馈
• 成绩 --查看所有成绩和讲师反馈
• 日历 --获取即将到来的截止日期和活动
• 课程内容 --浏览教学大纲、模块、主题和讲座
• 公告 --阅读讲师公告
• 文件下载 --从课程文件（docx、pdf等）下载和提取内容
• 研究工具 --任务跟踪、笔记同步、每周计划

先决条件

• v18+
• 麦克马斯特MacID(your-macid@mcmaster.ca)

设置

1.克隆并安装

git clone https://github.com/alanxue1/a2l-mcp.git
cd a2l-mcp/a2l-mcp
npm install
npx playwright install chromium

2.配置环境

cp .env.template .env

编辑 .env 使用您的麦克马斯特证书：

D2L_HOST=avenue.cllmcmaster.ca
D2L_SSO_LOGIN_URL=https://avenue.mcmaster.ca/login.php
D2L_USERNAME=your-macid@mcmaster.ca
D2L_PASSWORD=your-password

只有当你想要学习工具（任务跟踪、笔记搜索）时，才需要Supabase和OpenAI键。服务器在没有它们的情况下工作。

3.构建和验证

npm run build
node dist/auth-cli.js

浏览器将打开并通过McMaster的Microsoft SSO登录。完成任何MFA提示。会话已保存到 ~/.d2l-session/ 持续约24小时。

4.启动服务器

MCP_TRANSPORT=http node dist/index.js

服务器在上运行 http://localhost:3000/mcp.

连接到您的AI助手

光标

添加到MCP设置(.cursor/mcp.json):

{
  "mcpServers": {
    "a2l": {
      "url": "http://localhost:3000/mcp"
    }
  }
}

VS代码（副本）

添加到您的VS代码设置中：

{
  "mcp": {
    "servers": {
      "a2l": {
        "url": "http://localhost:3000/mcp"
      }
    }
  }
}

克劳德桌面版

添加 claude_desktop_config.json:

{
  "mcpServers": {
    "a2l": {
      "command": "node",
      "args": ["/path/to/a2l-mcp/a2l-mcp/dist/index.js"],
      "env": {
        "MCP_TRANSPORT": "stdio"
      }
    }
  }
}

日常使用

会议持续约24小时。每天：

cd a2l-mcp

# 1. Start the server
MCP_TRANSPORT=http node dist/index.js

# 2. If session expired, re-auth in a separate terminal
node dist/auth-cli.js

然后，只需与您的AI助手交谈： *“本周我有什么作业要交？”*

可用工具

学习工具（需要Supabase+OpenAI）

环境变量

故障排除

“找不到用户名字段” SSO登录页面结构可能已更改。打开错误日志问题。

会话很快过期 会议持续约24小时。跑 node dist/auth-cli.js 再一次。

MFA/2FA提示 浏览器将为您打开以完成MFA。之后，会话将自动保存。

学分

最初灵感来自 d2l mcp服务器 Mudkip将军。

许可证

麻省理工学院