🎓 MCP-сервер Canvas LMS

Надежный сервер Model Context Protocol (MCP), который подключает Claude AI к вашей учетной записи Canvas LMS, позволяя взаимодействовать с учебными материалами на естественном языке.

Создано на Python · Canvas REST API · MCP SDK

✨ Функции (14 инструментов в 4 модулях)

📚 Задания и курсы

Инструмент	Описание
`canvas_get_course_list`	Список всех активных курсов, на которые вы записаны
`canvas_get_assignments`	Получить все задания (все курсы или отфильтрованные)
`canvas_get_upcoming_deadlines`	Дедлайны на ближайшие N дней с цветовой кодировкой по срочности
`canvas_get_assignment_details`	Полная информация о конкретном задании
`canvas_get_submission_status`	Статус сдачи заданий (сдано/пропущено) по всем курсам

📊 Оценки

Инструмент	Описание
`canvas_get_course_grades`	Текущие оценки с визуальными индикаторами прогресса
`canvas_get_grade_breakdown`	Детализация оценок по заданиям с текущим итогом
`canvas_get_missing_assignments`	Все несданные задания

📢 Объявления и модули

Инструмент	Описание
`canvas_get_announcements`	Последние объявления по курсам
`canvas_get_course_modules`	Модули со статусом блокировки/завершения
`canvas_get_module_items`	Элементы модуля с флажками завершения

📅 Календарь

Инструмент	Описание
`canvas_get_calendar_events`	Все события на ближайшие N дней
`canvas_get_weekly_schedule`	Обзор недели
`canvas_get_upcoming_events`	Следующие N событий по всем курсам

🚀 Настройка

1. Клонируйте репозиторий

git clone https://github.com/yourusername/canvas-mcp.git
cd canvas-mcp

2. Установите зависимости

pip install -r requirements.txt

3. Настройте учетные данные Canvas

cp .env.example .env

Отредактируйте .env:

CANVAS_BASE_URL=https://yourschool.instructure.com
CANVAS_API_TOKEN=your_token_here

Как получить API-токен Canvas:

Войдите в Canvas
Перейдите в Account (Учетная запись) → Settings (Настройки)
Прокрутите до раздела Approved Integrations (Одобренные интеграции)
Нажмите New Access Token (Новый токен доступа)
Скопируйте токен в ваш файл .env

4. Настройте Claude Desktop

Добавьте это в ваш claude_desktop_config.json:

Mac: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "canvas": {
      "command": "python",
      "args": ["/absolute/path/to/canvas-mcp/server.py"],
      "env": {
        "CANVAS_BASE_URL": "canvas_base_url"
        "CANVAS_API_TOKEN": "your_token_here"
      }
    }
  }
}

5. Перезапустите Claude Desktop

Инструменты Canvas теперь появятся на боковой панели Claude!

💬 Примеры запросов

После подключения попробуйте спросить Claude:

"Какие задания мне нужно сдать на этой неделе?"
"Каков мой текущий средний балл (GPA)?"
"Есть ли у меня пропущенные задания?"
"Какие объявления недавно публиковали мои преподаватели?"
"Покажи детализацию моих оценок по курсу 12345"
"Как выглядит мое расписание на неделю?"

🗂️ Структура проекта

canvas-mcp/
├── server.py           # MCP server entry point (14 tools)
├── canvas_client.py    # Canvas REST API wrapper with pagination
├── tools/
│   ├── assignments.py  # Assignment & course tools
│   ├── grades.py       # Grade tools
│   ├── announcements.py# Announcement & module tools
│   └── calendar.py     # Calendar tools
├── .env.example        # Environment config template
├── requirements.txt
└── README.md

🔒 Конфиденциальность и безопасность

Только чтение — этот сервер никогда не записывает, не отправляет и не изменяет ваши данные в Canvas

🛠️ Технологический стек

Python 3.10+
MCP SDK — Model Context Protocol
httpx — Асинхронный HTTP-клиент
python-dotenv — Конфигурация окружения
Canvas LMS REST API

Canvas LMS MCP Server