Moodle Downloader

БесплатноНе проверен

Enables AI agents to download courses from any Moodle site for offline study, supporting authentication, course listing, and syncing via CLI or MCP.

автор: stojandev

GitHub Embed

Описание

Enables AI agents to download courses from any Moodle site for offline study, supporting authentication, course listing, and syncing via CLI or MCP.

README

Download courses from any Moodle site for offline study — CLI + MCP server for AI agents.

Personal use only. Don’t redistribute materials you download.

License: MIT Python 3.11+

Agents: README.agents.md · paste-ready prompt below.

Give this to your AI agent

Copy into Grok / Claude / Cursor / Codex (fill the blanks):

Install and set up Moodle Downloader MCP from:
https://github.com/stojandev/moodle-downloader-mcp

1. Clone the repo (or use my existing checkout), create a venv, pip install -e .
2. Read README.agents.md and follow it (always use --json; never print passwords/tokens).
3. Ask me only for:
   - Moodle base URL (e.g. https://moodle.my-school.edu)
   - Username (exactly as on the portal — don’t invent the format)
   - Password (or webservice token if I have one)
4. Run: moodle-agent probe --url <URL> --json
5. Then: init with MOODLE_URL / MOODLE_USER / MOODLE_PASS (or --token) --out ./courses --force --json
6. Verify: moodle-agent whoami --json
7. Sync all courses: moodle-agent sync --out ./courses --json
8. Optionally register MCP: moodle-agent-mcp from the venv (see README).

My Moodle URL: _______________
My username: _______________

Install

Requires: Python 3.11+

git clone https://github.com/stojandev/moodle-downloader-mcp.git
cd moodle-downloader-mcp

Linux / macOS

python3 -m venv .venv
source .venv/bin/activate
pip install -e .

Windows (PowerShell)

python -m venv .venv
.\.venv\Scripts\Activate.ps1
pip install -e .

Check:

moodle-agent version

Command	Role
`moodle-agent`	CLI
`moodle-agent-mcp`	MCP server (for AI tools)

Quick start

moodle-agent setup
moodle-agent init --url "https://moodle.example.edu" -u YOUR_USER
moodle-agent courses list
moodle-agent sync --out ./courses

Any school — pass your Moodle URL; username is whatever you use on the portal.
Password is prompted and not stored (only a token).
Config: ~/.config/moodle-agent/ · Windows %APPDATA%\moodle-agent\

MCP (optional)

Point your client at the binary from the venv:

# e.g. ~/.grok/config.toml
[mcp_servers.moodle-agent]
command = "/full/path/to/.venv/bin/moodle-agent-mcp"   # Windows: ...\.venv\Scripts\moodle-agent-mcp.exe
enabled = true
tool_timeout_sec = 3600

Docs


README.agents.md	AI agents — auth, commands, MCP
docs/WIKI.md	LLM wiki (cheap follow-up sessions)
docs/AGENT_GUIDE.md	Full agent runbook

Limits (v0.1): no forums/quizzes; course-level download only; Python 3.11+.

License

from github.com/stojandev/moodle-downloader-mcp

Установка Moodle Downloader

У этого сервера нет опубликованного пакета — он собирается из исходников. Открой репозиторий и следуй инструкции в README.

▸ github.com/stojandev/moodle-downloader-mcp

FAQ