Moodle MCP: сроки, задания, оценки и файлы курса для агента

Faixiang/Moodle-MCP· Проверено 12.11.2026· 205на GitHub

Подключает агента к Moodle через Web Service API по личному токену: курсы, задания и дедлайны, тесты, оценки и файлы курса. Для преподавателя есть вариант с проверкой работ и отзывами.

3 реализации:

Один файл на Python без зависимостей и только чтение: сводка за неделю, несданные задания с днями до срока, состояние тестов, файлы курса и скачивание недели.

Как подключить

Что сделать до подключения

Python 3.8 или новее, пакеты ставить не нужно

Moodle 3.x или 4.x с включёнными Web Services и протоколом REST

Скачать server.py; вместо переменных можно положить рядом config.json с url и token

MOODLE_TOKEN

Moodle → аватар → Preferences → Account → Security → Manage access keys → Create, сервис Moodle mobile web service

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --env 'MOODLE_URL=https://<ваш Moodle>' --env 'MOODLE_TOKEN=<ваш токен>' --transport stdio moodle \
  -- python '<путь к Moodle-MCP>/server.py'

Проверка: claude mcp list показывает статус рядом с каждым сервером: ✔ Connected, ! Needs authentication или ✘ Failed to connect. Внутри сессии то же видно по команде /mcp.

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.moodle]
command = "python"
args = ["<путь к Moodle-MCP>/server.py"]

[mcp_servers.moodle.env]
MOODLE_URL = "https://<ваш Moodle>"
MOODLE_TOKEN = "<ваш токен>"

Проверка: В интерфейсе codex введите /mcp: появится список активных серверов. Из терминала то же покажет codex mcp list.

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "moodle": {
      "command": "python",
      "args": ["<путь к Moodle-MCP>/server.py"],
      "env": {
        "MOODLE_URL": "https://<ваш Moodle>",
        "MOODLE_TOKEN": "<ваш токен>"
      }
    }
  }
}

Проверка: Откройте Customize в боковой панели: там список серверов с переключателями. Ошибки подключения смотрите в панели Output (Cmd+Shift+U), пункт MCP Logs в выпадающем списке.

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "moodle": {
      "type": "stdio",
      "command": "python",
      "args": ["<путь к Moodle-MCP>/server.py"],
      "env": {
        "MOODLE_URL": "https://<ваш Moodle>",
        "MOODLE_TOKEN": "<ваш токен>"
      }
    }
  }
}

Проверка: Попросите Copilot выполнить безобидную задачу через сервер и раскройте вызов инструмента в чате. Одна запись в конфиге подключение не подтверждает.

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "moodle": {
      "command": "python",
      "args": ["<путь к Moodle-MCP>/server.py"],
      "env": {
        "MOODLE_URL": "https://<ваш Moodle>",
        "MOODLE_TOKEN": "<ваш токен>"
      }
    }
  }
}

Проверка: Запустите qwen и введите /mcp: откроется окно управления серверами. Из терминала статус покажет qwen mcp list.

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "moodle": {
      "command": "python",
      "args": ["<путь к Moodle-MCP>/server.py"],
      "env": {
        "MOODLE_URL": "https://<ваш Moodle>",
        "MOODLE_TOKEN": "<ваш токен>"
      }
    }
  }
}

Проверка: gemini mcp list показывает каждый сервер, его настройки и статус Connected или Disconnected. В сессии /mcp выводит CONNECTED, CONNECTING или DISCONNECTED и список инструментов.

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "moodle": {
        "type": "local",
        "command": ["python", "<путь к Moodle-MCP>/server.py"],
        "environment": {
          "MOODLE_URL": "https://<ваш Moodle>",
          "MOODLE_TOKEN": "<ваш токен>"
        }
      }
    }
  }
}

Проверка: opencode mcp list показывает состояние каждого сервера, подключённый выглядит как ✓ context7 connected. Внутри OpenCode то же видно в /mcps.

Настройки → Разработчик → Изменить конфиг: файл claude_desktop_config.json. После правки перезапустите приложение. Подробно о Claude Desktop

{
  "mcpServers": {
    "moodle": {
      "command": "python",
      "args": ["<путь к Moodle-MCP>/server.py"],
      "env": {
        "MOODLE_URL": "https://<ваш Moodle>",
        "MOODLE_TOKEN": "<ваш токен>"
      }
    }
  }
}

Проверка: Нажмите «Add files, connectors, and more /» в левом нижнем углу поля ввода, наведите на Connectors и откройте Manage connectors. Выберите сервер, чтобы увидеть его инструменты.

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "moodle": {
      "command": "python",
      "args": ["<путь к Moodle-MCP>/server.py"],
      "env": {
        "MOODLE_URL": "https://<ваш Moodle>",
        "MOODLE_TOKEN": "<ваш токен>"
      }
    }
  }
}

Проверка: Попросите модель в чате выполнить задачу через инструмент сервера. Через API сервер из mcp.json вызывают по id в integrations, например mcp/playwright.

Инструменты сервера

moodle_weekly_digestсводит новое, сроки и долги за неделю

moodle_pending_assignmentsпоказывает несданные задания и сроки

moodle_quiz_statusпоказывает попытки и баллы тестов

moodle_recent_updatesпоказывает новое за N дней

moodle_list_coursesперечисляет курсы

moodle_course_filesперечисляет файлы курса

moodle_download_weekскачивает файлы недели

moodle_site_infoпроверяет токен и доступные функции

moodle_setup_guideобъясняет, как получить токен

moodle_config_statusпроверяет настройку сервера

31 инструмент для студента: оценки и прогресс, поиск по материалам, разбор задания на шаги и план, скачивание файлов курса, самозапись на курс; запуск через uvx.

Как подключить

Что сделать до подключения

uv с командой uvx

MOODLE_TOKEN

откройте https://<ваш Moodle>/user/managetoken.php и возьмите токен со службой Moodle mobile web service

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --env 'MOODLE_URL=https://<ваш Moodle>/webservice/rest/server.php' --env 'MOODLE_TOKEN=<ваш токен>' --transport stdio moodle-mcp \
  -- uvx moodle-mcp

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.moodle-mcp]
command = "uvx"
args = ["moodle-mcp"]

[mcp_servers.moodle-mcp.env]
MOODLE_URL = "https://<ваш Moodle>/webservice/rest/server.php"
MOODLE_TOKEN = "<ваш токен>"

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "moodle-mcp": {
      "command": "uvx",
      "args": ["moodle-mcp"],
      "env": {
        "MOODLE_URL": "https://<ваш Moodle>/webservice/rest/server.php",
        "MOODLE_TOKEN": "<ваш токен>"
      }
    }
  }
}

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "moodle-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": ["moodle-mcp"],
      "env": {
        "MOODLE_URL": "https://<ваш Moodle>/webservice/rest/server.php",
        "MOODLE_TOKEN": "<ваш токен>"
      }
    }
  }
}

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "moodle-mcp": {
      "command": "uvx",
      "args": ["moodle-mcp"],
      "env": {
        "MOODLE_URL": "https://<ваш Moodle>/webservice/rest/server.php",
        "MOODLE_TOKEN": "<ваш токен>"
      }
    }
  }
}

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "moodle-mcp": {
      "command": "uvx",
      "args": ["moodle-mcp"],
      "env": {
        "MOODLE_URL": "https://<ваш Moodle>/webservice/rest/server.php",
        "MOODLE_TOKEN": "<ваш токен>"
      }
    }
  }
}

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "moodle-mcp": {
        "type": "local",
        "command": ["uvx", "moodle-mcp"],
        "environment": {
          "MOODLE_URL": "https://<ваш Moodle>/webservice/rest/server.php",
          "MOODLE_TOKEN": "<ваш токен>"
        }
      }
    }
  }
}

{
  "mcpServers": {
    "moodle-mcp": {
      "command": "uvx",
      "args": ["moodle-mcp"],
      "env": {
        "MOODLE_URL": "https://<ваш Moodle>/webservice/rest/server.php",
        "MOODLE_TOKEN": "<ваш токен>"
      }
    }
  }
}

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "moodle-mcp": {
      "command": "uvx",
      "args": ["moodle-mcp"],
      "env": {
        "MOODLE_URL": "https://<ваш Moodle>/webservice/rest/server.php",
        "MOODLE_TOKEN": "<ваш токен>"
      }
    }
  }
}

Инструменты сервера

get_my_coursesперечисляет мои курсы

get_course_contentпоказывает разделы и модули курса

search_course_materialsищет по материалам курсов

get_upcoming_deadlinesпоказывает ближайшие сроки

get_overdue_assignmentsпоказывает просроченные задания

get_assignment_statusпоказывает статус сдачи и оценку

extract_assignment_requirementsвыделяет требования задания

decompose_taskразбивает задание на подзадачи

create_implementation_planстроит план выполнения

get_gradesпоказывает оценки

get_course_progressпоказывает прогресс по курсу

get_study_loadпоказывает нагрузку по неделям

daily_briefingдаёт сводку на день

download_course_filesскачивает все файлы курса

search_coursesищет курсы в каталоге

self_enrol_courseзаписывает на курс

ask_moodleотвечает на вопрос по данным Moodle

Показано 17 из 31.

Для преподавателя одного курса: список студентов, сданные работы и попытки тестов, выставление оценок и комментариев.

Как подключить

Что сделать до подключения

Node.js 14 или новее

Склонировать репозиторий, выполнить npm install и npm run build

MOODLE_API_TOKEN

администратор: Site Administration → Plugins → Web Services → Manage tokens → новый токен с правами на управление курсом

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --env 'MOODLE_API_URL=https://<ваш Moodle>/webservice/rest/server.php' --env 'MOODLE_API_TOKEN=<токен API>' --env 'MOODLE_COURSE_ID=<ID курса>' --transport stdio moodle-mcp-server \
  -- node '<путь к moodle-mcp-server>/build/index.js'

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.moodle-mcp-server]
command = "node"
args = ["<путь к moodle-mcp-server>/build/index.js"]

[mcp_servers.moodle-mcp-server.env]
MOODLE_API_URL = "https://<ваш Moodle>/webservice/rest/server.php"
MOODLE_API_TOKEN = "<токен API>"
MOODLE_COURSE_ID = "<ID курса>"

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "moodle-mcp-server": {
      "command": "node",
      "args": ["<путь к moodle-mcp-server>/build/index.js"],
      "env": {
        "MOODLE_API_URL": "https://<ваш Moodle>/webservice/rest/server.php",
        "MOODLE_API_TOKEN": "<токен API>",
        "MOODLE_COURSE_ID": "<ID курса>"
      }
    }
  }
}

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "moodle-mcp-server": {
      "type": "stdio",
      "command": "node",
      "args": ["<путь к moodle-mcp-server>/build/index.js"],
      "env": {
        "MOODLE_API_URL": "https://<ваш Moodle>/webservice/rest/server.php",
        "MOODLE_API_TOKEN": "<токен API>",
        "MOODLE_COURSE_ID": "<ID курса>"
      }
    }
  }
}

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "moodle-mcp-server": {
      "command": "node",
      "args": ["<путь к moodle-mcp-server>/build/index.js"],
      "env": {
        "MOODLE_API_URL": "https://<ваш Moodle>/webservice/rest/server.php",
        "MOODLE_API_TOKEN": "<токен API>",
        "MOODLE_COURSE_ID": "<ID курса>"
      }
    }
  }
}

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "moodle-mcp-server": {
      "command": "node",
      "args": ["<путь к moodle-mcp-server>/build/index.js"],
      "env": {
        "MOODLE_API_URL": "https://<ваш Moodle>/webservice/rest/server.php",
        "MOODLE_API_TOKEN": "<токен API>",
        "MOODLE_COURSE_ID": "<ID курса>"
      }
    }
  }
}

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "moodle-mcp-server": {
        "type": "local",
        "command": ["node", "<путь к moodle-mcp-server>/build/index.js"],
        "environment": {
          "MOODLE_API_URL": "https://<ваш Moodle>/webservice/rest/server.php",
          "MOODLE_API_TOKEN": "<токен API>",
          "MOODLE_COURSE_ID": "<ID курса>"
        }
      }
    }
  }
}

{
  "mcpServers": {
    "moodle-mcp-server": {
      "command": "node",
      "args": ["<путь к moodle-mcp-server>/build/index.js"],
      "env": {
        "MOODLE_API_URL": "https://<ваш Moodle>/webservice/rest/server.php",
        "MOODLE_API_TOKEN": "<токен API>",
        "MOODLE_COURSE_ID": "<ID курса>"
      }
    }
  }
}

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "moodle-mcp-server": {
      "command": "node",
      "args": ["<путь к moodle-mcp-server>/build/index.js"],
      "env": {
        "MOODLE_API_URL": "https://<ваш Moodle>/webservice/rest/server.php",
        "MOODLE_API_TOKEN": "<токен API>",
        "MOODLE_COURSE_ID": "<ID курса>"
      }
    }
  }
}

Инструменты сервера

get_coursesчитает сведения о курсах

list_studentsперечисляет студентов курса

get_assignmentsперечисляет задания

get_student_submissionsсмотрит работы студента

provide_assignment_feedbackставит оценку и комментарий

get_quizzesперечисляет тесты

get_quiz_attemptsсмотрит попытки теста

provide_quiz_feedbackкомментирует попытку теста

Что попросить агента

«Что мне нужно сдать на этой неделе?»Faixiang вызовет moodle_weekly_digest и вернёт таблицы со сроками, просрочками и итогами

«Какие новые материалы появились в курсе <курс> за неделю?»Faixiang вызовет moodle_recent_updates

«Покажи файлы курса <курс>, ничего не скачивай»Faixiang вызовет moodle_course_files

«Разбери задание <название>: требования, шаги и план до дедлайна»loyaniu вызовет extract_assignment_requirements, decompose_task и create_implementation_plan

«Покажи работы студента <имя> по заданию <ID> и поставь 8 с комментарием <текст>»peancor вызовет get_student_submissions и provide_assignment_feedback

Для каких задач

Узнать, что ещё не сдано на этой неделе и сколько дней осталось до срока

Посмотреть, какие материалы появились в курсе за последние дни

Скачать слайды и файлы заданий за неделю в папку на компьютере

Разобрать задание на требования, шаги и план работы

Проверить работы студентов и выставить оценки с комментариями

Ограничения

На сайте Moodle должны быть включены Web Services и протокол REST, а у аккаунта — право webservice/rest:use

Faixiang не видит сроки Turnitin: у этого модуля нет поля срока сдачи

loyaniu умеет записывать на курс, а peancor ставит оценки: оба меняют данные в Moodle

Moodle MCP Server от peancor последний раз обновлялся в феврале 2026 года и нужен токен администратора с правами на курс

Если не работает

get_token.py отвечает invalidlogin

Аккаунт входит только через SSO, локального пароля нет. Создайте токен в Manage access keys.

Ошибка 502 или обрыв соединения во время вызова

Сайт ограничивает частоту запросов. Подождите несколько минут и не вызывайте инструменты параллельно.

Инструменты возвращают пустые списки

Проверьте, что Web Services и REST включены на сайте, у аккаунта есть право webservice/rest:use, а course_ids указаны верно. Вызовите moodle_site_info: короткий список функций значит, что администратор ограничил токен.

Сроков тестов нет в moodle_weekly_digest

Так задумано: тесты живут в mod_quiz, для них есть moodle_quiz_status.

Кракозябры в терминале Windows

Вывод в UTF-8: в старой консоли выполните chcp 65001 или откройте Windows Terminal.

Какую реализацию выбрать

Реализация	Кто делает	Звёзды	Запуск	Ключ	Инструменты	Обновлён
Moodle-MCP (Faixiang)	Faixiang	205	локально	токен	10	1 ноября 2026
Moodle-MCP (loyaniu)	loyaniu	57	локально	токен	31	6 ноября 2026
Moodle MCP Server (peancor)	peancor	45	локально	токен	8	22 февраля 2026

Частые вопросы

Где взять токен Moodle?

Студенту: аватар → Preferences → Account → Security → Manage access keys, создать ключ со службой Moodle mobile web service; тот же список открывается по адресу /user/managetoken.php. Так работает и вход через SSO. Токен для peancor создаёт администратор в Site Administration → Plugins → Web Services → Manage tokens.

Какой вариант выбрать?

Студенту для обзора долгов и сроков хватит Faixiang: он только читает и не требует зависимостей. loyaniu шире: оценки, прогресс, разбор задания и самозапись на курс. Преподавателю для проверки работ нужен peancor.

Опасно ли давать агенту токен?

Токен даёт доступ к вашему аккаунту Moodle. У Faixiang все инструменты только читают, поэтому через него ничего не удалить, но ссылки на файлы содержат токен: не публикуйте их. При утечке отзовите токен в Manage access keys.

Что значит ошибка 502 во время вызова?

Сайт ограничивает частоту запросов. Faixiang и так делает паузу 150 мс между вызовами; подождите несколько минут и не запускайте несколько инструментов одновременно.

Как подключить Moodle MCP к Claude Desktop?

Для loyaniu добавьте в claude_desktop_config.json сервер с command uvx, args moodle-mcp и переменными MOODLE_URL и MOODLE_TOKEN, затем перезапустите Claude. Для Faixiang укажите python и абсолютный путь к server.py.

Работает ли сервер из России?

Серверы запускаются на вашем компьютере и обращаются только к сайту вашего Moodle, зарубежные аккаунты не нужны.

Moodle MCP: сроки, задания, оценки и файлы курса для агента

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

Что попросить агента

Для каких задач

Ограничения

Если не работает

Какую реализацию выбрать

Частые вопросы

Похожие серверы