MCP 服务器

Moodle Downloader MCP

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

README

Moodle Downloader MCP

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

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

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

<details> <summary><strong>Linux / macOS</strong></summary>

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

</details>

<details> <summary><strong>Windows (PowerShell)</strong></summary>

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

</details>

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