brightspace-mcp-server-ddd

MCP-сервер для D2L Brightspace с архитектурой DDD, многостратегической аутентификацией и операциями записи по выбору.

Статус: В активной разработке. Не готов к промышленному использованию.

Быстрый старт (предварительная версия плана 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] План 1: Основа + вертикальный срез (check_auth, list_my_courses, аутентификация api_token)

• [ ] План 2: Браузер, OAuth, сессионные cookie, headless + MFA (TOTP, Duo, вручную)

• [ ] План 3: Повторные попытки/экспоненциальная задержка, ограничение частоты запросов, объединение, кэш File/Redis

• [ ] Планы 4–8: Оставшиеся контексты, мастер настройки CLI, операции записи, конвейер выпуска

Лицензия

MIT