Canvas LMS MCP Server

Сервер Model Context Protocol, который предоставляет MCP-клиенту (Claude Desktop, Claude Code или любому другому приложению, говорящему на MCP) доступ только для чтения к вашему аккаунту Canvas LMS.

Он отвечает на два вопроса:

• «Что я прохожу и как у меня дела?» — активные курсы с текущими оценками.

• «Что мне ещё нужно сдать и когда срок?» — несданные задания со сроками сдачи.

Связь осуществляется через стандартный транспорт stdio, поэтому клиент запускает сервер как дочерний процесс. В stdout не выводится ничего, кроме MCP-трафика.

Требования

• Node.js 18.17 или новее (сервер использует встроенный fetch)

• Персональный токен доступа Canvas

Related MCP server: Canvas MCP Server

Установка

cd canvas-mcp-server
npm install

Конфигурация

Обе переменные обязательны; сервер завершает работу с понятным сообщением, если какая-либо из них отсутствует.

Получение токена доступа Canvas

1. Войдите в Canvas.

2. Перейдите в Account → Settings.

3. В разделе Approved Integrations нажмите + New Access Token.

4. Укажите назначение и (при желании) срок действия, затем нажмите Generate Token.

5. Скопируйте токен сразу же — Canvas показывает его только один раз.

Токен несёт все ваши привилегии Canvas. Не храните его в системе контроля версий и отзовите его на той же странице настроек, если он когда-либо утёк.

Подключение клиента

Добавьте сервер в конфигурацию вашего MCP-клиента, указав абсолютный путь к src/index.js:

{
  "mcpServers": {
    "canvas": {
      "command": "node",
      "args": ["/absolute/path/to/canvas-mcp-server/src/index.js"],
      "env": {
        "CANVAS_API_URL": "https://asu.instructure.com",
        "CANVAS_ACCESS_TOKEN": "your-token-here"
      }
    }
  }
}

• Claude Desktop — claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\).

• Claude Code — claude mcp add canvas --env CANVAS_API_URL=... --env CANVAS_ACCESS_TOKEN=... -- node /absolute/path/to/canvas-mcp-server/src/index.js

Перезапустите клиент после изменения конфигурации.

Инструменты

list_courses_and_grades

Все курсы, на которые вы активно зачислены как студент, с текущей оценкой.

Canvas сообщает оценки дважды, когда ваше учебное заведение использует периоды оценивания: один раз за текущий период и один раз за весь курс. Поле grades.scope указывает, на какой из них вы смотрите:

• current_grading_period — оценка охватывает текущий период оценивания, а course_total_score / course_total_grade содержат показатели за весь курс.

• course_total — учебное заведение не использует периоды оценивания, поэтому оценка является итоговой по курсу.

• unavailable — Canvas не вернул зачисление с данными об оценках.

В рамках любого из этих значений current_* игнорирует работы, которые ещё не оценены, а final_* учитывает неоценённые работы как ноль.

{
  "courses": [
    {
      "id": "101",
      "name": "Full Stack Web Development",
      "course_code": "GIT-411",
      "term": "Fall 2026",
      "term_start": "2026-08-20T00:00:00Z",
      "term_end": "2026-12-18T00:00:00Z",
      "enrollment_state": "active",
      "grades": {
        "current_score": 88.0,
        "current_grade": "B+",
        "final_score": 80.5,
        "final_grade": "B-",
        "scope": "current_grading_period",
        "grading_period_title": "Fall Term",
        "course_total_score": 91.4,
        "course_total_grade": "A-"
      },
      "html_url": "https://asu.instructure.com/courses/101"
    }
  ],
  "course_count": 1,
  "retrieved_at": "2026-09-01T12:00:00.000Z"
}

list_upcoming_assignments

Задания по вашим активным курсам, которые ещё не сданы, отсортированные по сроку сдачи — сначала ближайшие.

Задание считается несданным, когда оно опубликовано, подлежит оцениванию и не сдано, не оценено и не освобождено от сдачи. Конкретно отфильтровываются:

• всё, у чего есть отметка времени отправки

• отправки в состоянии submitted, pending_review или graded

• задания, освобождённые от сдачи

• задания, у которых уже есть балл или оценка (введённые вручную или на бумаге)

• задания not_graded (заглушки посещаемости и тому подобное)

• неопубликованные задания

{
  "assignments": [
    {
      "id": "9004",
      "name": "Missed lab writeup",
      "course_id": "101",
      "course_name": "Full Stack Web Development",
      "due_at": "2026-08-28T06:59:00.000Z",
      "days_until_due": -4.2,
      "overdue": true,
      "points_possible": 25,
      "submission_types": ["online_upload"],
      "submission_state": "unsubmitted",
      "missing": true,
      "locked": false,
      "unlock_at": null,
      "lock_at": null,
      "html_url": "https://asu.instructure.com/courses/101/assignments/9004"
    }
  ],
  "assignment_count": 1,
  "courses_checked": 2,
  "window": {
    "from": "2026-09-01T12:00:00.000Z",
    "to": "2026-09-15T12:00:00.000Z",
    "include_overdue": true,
    "include_undated": false
  },
  "errors": [],
  "retrieved_at": "2026-09-01T12:00:00.000Z"
}

Если один курс не удаётся прочитать — завершён, ограничен или вызывает ошибку — он указывается в errors, а остальные курсы по-прежнему возвращают результаты.

Замечания о поведении

• Пагинация. Canvas разбивает каждую коллекцию на страницы через заголовок Link. Клиент следует за rel="next" по 100 записей на страницу, с ограничением в 20 страниц на конечную точку, чтобы ошибочный ответ не мог зациклиться навсегда.

• Параллельность. Задания загружаются не более чем с 5 курсов одновременно, чтобы не превышать лимиты частоты запросов Canvas.

• Текущий семестр. По умолчанию возвращаются только курсы, семестр которых ещё не завершился. Семестр Canvas по умолчанию не имеет даты окончания и включается всегда.

• Ошибки. Сбои Canvas возвращаются как ошибки MCP-инструмента с кодом состояния и собственным сообщением Canvas, а также подсказкой для типичных случаев (401 → неверный токен, 404 → неверный URL).

• Только чтение. Оба инструмента помечены readOnlyHint. Сервер отправляет только GET-запросы и никогда не изменяет ваши данные Canvas.

Разработка

npm test    # 36 tests: API client, grade logic, filtering, and an end-to-end MCP round trip

Набор тестов использует замену fetch с записанными ответами Canvas, поэтому сеть или реальный токен не нужны. Все даты в фикстурах относительны к моменту запуска тестов.

src/
  index.js        MCP server: tool definitions, schemas, stdio wiring
  canvas.js       Canvas REST client: auth, pagination, error mapping
  courses.js      Active-course and grade normalization
  assignments.js  Outstanding-assignment filtering and due-date windows

Лицензия

MIT