brightspace-mcp-server-ddd

用于 D2L Brightspace 的 MCP 服务器，采用 DDD 架构，支持多策略身份验证和选择性加入的写入操作。

状态： 开发中。尚未达到生产就绪状态。

快速入门 (Plan 1 预览)

1. 克隆并安装：

   git clone <this repo>
   cd brightspace-mcp-server-ddd
   npm install
   npm run build

2. 创建 ~/.brightspace-mcp/config.yaml：

   default_profile: my_school
   profiles:
     my_school:
       base_url: https://your-school.brightspace.com
       auth:
         strategy: api_token
         api_token: { token_ref: env:BRIGHTSPACE_API_TOKEN }

3. 导出您的 D2L Valence 令牌并运行：

   export BRIGHTSPACE_API_TOKEN="<your-token>"
   node build/cli/main.js serve

4. 将二进制文件注册到您的 MCP 客户端（例如 Claude Desktop）：

   { "brightspace": { "command": "node", "args": ["/abs/path/to/build/cli/main.js", "serve"] } }

Related MCP server: Nettskjema MCP Server

状态

• [x] Plan 1: 基础架构 + 垂直切片 (check_auth, list_my_courses, api_token 认证)

• [ ] Plan 2: 浏览器、OAuth、会话 Cookie、无头模式 + MFA (TOTP, Duo, 手动)

• [ ] Plan 3: 重试/退避、速率限制、合并请求、文件/Redis 缓存

• [ ] Plans 4–8: 其余上下文、CLI 向导、写入操作、发布流水线

许可证

MIT