ase-moodle: BL@ASE (online.ase.ro) pentru agenți AI
Client Python, CLI, server MCP și plugin pentru Moodle-ul BL@ASE. Îți permite să folosești contul tău de Moodle din Claude Code, Codex, opencode și Google Antigravity: cursuri, materiale, teme, forumuri, note, quizuri, notificări și termene.
In English: an MCP server, CLI and plugin that gives AI agents (Claude Code, Codex, opencode, Google Antigravity) access to your Moodle account at BL@ASE / online.ase.ro: courses, course materials, assignments, forums, grades, quizzes, notifications and deadlines. Keywords: Moodle, BL@ASE, ASE Bucharest, online.ase.ro, MCP, Model Context Protocol, Claude Code plugin, Codex plugin, opencode, Antigravity, student tools.
Site: https://ase-moodle-mcp.danubelabs.net/
Ce poate face
- listează cursurile pe an de studiu, semestru și tip (CURS / SEMINAR / LABORATOR);
- descarcă materialele unui curs sau ale unui an, în paralel: fișiere, pagini, linkuri, teme, forumuri, quizuri, note;
- citește temele, starea trimiterii și feedbackul; vede dacă o temă are ciorne;
- trimite teme (ciornă sau final), răspunde pe forum, deschide discuții (cu confirmarea ta);
- răspunde la quizuri: citește întrebările, salvează răspunsurile, trimite încercarea (cu aprobarea ta);
- vede notificările și termenele, marchează notificările ca citite;
- apelează orice funcție Web Service Moodle (395 disponibile pentru token).
Instalare
Ai nevoie de Python 3.10+. Poți instala cu pipx (fără Node.js) sau cu npm (dacă ai Node.js 18+). Rezultatul e același.
Cu pipx. Pipx se instalează o singură dată: python -m pip install --user pipx.
pipx install git+https://github.com/FiredMosquito831/ase-moodle-mcp.git
ase-moodle login
ase-moodle install
ase-moodle doctor
Cu npm:
npm install -g ase-moodle-mcp
ase-moodle login
ase-moodle install
ase-moodle doctor
Instalarea prin npm pune și pachetul Python, prin pipx. La prima instalare durează câteva minute, iar npm nu afișează progresul. Pentru progres: npm install -g --foreground-scripts ase-moodle-mcp.
Fără instalare globală, după ce ai npm: npx ase-moodle-mcp auth-status.
| Comandă | Ce face |
|---|
pipx install git+… sau npm install -g ase-moodle-mcp | instalează ase-moodle și serverul MCP (pachetul Python, izolat de restul Python-ului) |
ase-moodle login | te loghezi în Moodle în browser, cu Google (o singură dată) |
ase-moodle install | adaugă pluginul în Claude Code, Codex, opencode și Antigravity |
ase-moodle doctor | verifică instalarea și arată ce lipsește |
Doar pentru folderul curent: ase-moodle install --scope project. Dacă nu ai Edge sau Chrome, login-ul cere Chromium: python -m playwright install chromium.
Actualizare și dezinstalare, pe fiecare metodă: actualizare, dezinstalare. Dezinstalarea completă are mai mulți pași, pentru că pluginul și pachetul sunt instalate separat.
Pașii detaliați, cerințele și toate variantele (pipx, npm, script, pip) sunt în docs/INSTALL.md.
Comenzi de bază
ase-moodle login # token (browser; sau --method manual)
ase-moodle auth-status # ești logat?
ase-moodle install # configurează toate CLI-urile (global)
ase-moodle install claude --scope project # doar folderul curent
ase-moodle codex doctor # un singur harness: install|update|uninstall|doctor
ase-moodle doctor # starea instalării
ase-moodle deadlines --days 14
ase-moodle download --year 3 --sem 1 --out D:\Materiale
npx ase-moodle-mcp deadlines --days 14 # la fel, fără instalare globală (după npm)
Lista completă: docs/USAGE.md.
Documentație
| Document | Ce conține |
|---|
| docs/INSTALL.md | cerințe pe Windows și Linux, variantele de instalare (pipx, npm, script, pip), actualizare, dezinstalare |
| docs/USAGE.md | referința CLI: fiecare comandă, opțiune, exemplu, coduri de ieșire |
| docs/MCP.md | cele 28 de unelte MCP, prompturile, resursele, conectarea clienților |
| docs/PLATFORMS.md | Claude Code, Codex, opencode, Antigravity: ce se instalează, scopurile, fișierele atinse |
| docs/HARNESSES.md | adaptoarele izolate: comenzile per harness, evidența fiecăruia, ce returnează doctor |
| docs/AUTH.md | obținerea tokenului, unde e stocat, parola Google, deconectare |
| docs/CONFIGURATION.md | variabile de mediu, .env, config.json, folderul de descărcare |
| docs/SAFETY.md | confirmări, garda pentru ciorne, politica pentru quizuri, reguli de utilizare |
| docs/SECURITATE-PE-INTELES.md | noțiuni de bază despre secrete, explicate simplu |
|
Stare verificată
Verificat pe contul real (octombrie 2026):
- autentificare prin browser (SSO) și salvare în Credential Manager;
- cursuri, teme, forumuri, notificări, termene, note, quizuri (citire);
- descărcarea unui an și semestru: a doua rulare nu descarcă nimic;
- erori fără efecte: quiz închis, obiecte inexistente, fișier inexistent;
- garda pentru ciorne: refuză o salvare pe o temă fără ciorne, fără să trimită nimic;
- instalare, verificare (
doctor) și dezinstalare, pe Claude Code, Codex și opencode, atât global cât și pe proiect, și pe Antigravity (global);
- testele trec pe Windows. Pe Linux (WSL Ubuntu 24.04) au trecut înainte de ultimele modificări și nu au fost rerulate.
Netestat pe contul real: update pentru toate platformele și o trimitere reală cu ciorne activate (nu există astfel de situații acum). Detalii în docs/TESTING.md.
Limite
- Mesageria Moodle este dezactivată pe site.
- Funcțiile Web Service sunt cele ale serviciului mobil Moodle. Ce există doar în interfața web nu se acoperă.
- Antigravity se instalează doar global.
- macOS nu e testat.
Licență
Cod sub Apache License 2.0. Dacă distribui sau modifici codul, păstrezi notele de copyright din NOTICE și menționezi sursa (repo-ul și autorul).
