moodle-mcp-server

maldalur/moodle-mcp-server

3.2

If you are the rightful owner of moodle-mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to dayong@mcphub.com.

The Moodle MCP Server is a Model Context Protocol server that facilitates interaction between LLMs and the Moodle platform for course management.

Moodle AI Grader & Submission Tracker

Overview

The Moodle AI Grader is a Python application that connects to the Moodle platform via its REST API to automate the grading process of student submissions based on predefined rubric criteria. The application retrieves task descriptions, student submissions, and utilizes AI algorithms to evaluate the submissions against the rubric.

✨ New Features

  • 🎯 Quiz Support: Obtiene y rastrea calificaciones de quizzes
  • 📦 Smart Caching: Sistema de caché inteligente que detecta cambios
  • 📊 Reports: Genera reportes de calificaciones en consola o CSV
  • 🔄 Incremental Processing: Solo procesa entregas nuevas o modificadas
  • 💾 Multiple Formats: Soporte para VPL, Asignaciones normales y Quizzes

Project Structure

moodle-ai-grader
├── src
│   ├── main.py               # Entry point of the application
│   ├── moodle_client.py      # Handles connection to Moodle API
│   ├── rubric_parser.py      # Extracts rubric criteria from task descriptions
│   ├── ai_grader.py          # Grades submissions using AI algorithms
│   └── models.py             # Defines data models for tasks and submissions
├── tests
│   ├── test_moodle_client.py # Unit tests for MoodleClient
│   ├── test_rubric_parser.py # Unit tests for RubricParser
│   └── test_ai_grader.py     # Unit tests for AIGrader
├── .env                      # Environment variables for configuration
├── requirements.txt          # Project dependencies
└── README.md                 # Project documentation

Setup Instructions

  1. Clone the repository:

    git clone <repository-url>
cd moodle-ai-grader

  2. Create a virtual environment:

    python -m venv venv
source venv/bin/activate  # On Windows use `venv\Scripts\activate`

  3. Install the required dependencies:

    pip install -r requirements.txt

  4. Configure the environment variables in the .env file:

    MOODLE_API_URL=<your_moodle_api_url>
MOODLE_API_KEY=<your_moodle_api_key>

Usage

Procesamiento principal (con caché automático)

python src\main.py

Generar reporte de quizzes

# Reporte en consola
python quiz_report.py

# Exportar a CSV
python quiz_report.py --export reporte.csv

Gestionar caché

# Ver estadísticas
python cache_manager.py stats

# Listar entregas
python cache_manager.py list

# Limpiar caché (forzar reprocesamiento)
python cache_manager.py clear

Functionality

  • MoodleClient: Connects to the Moodle REST API and retrieves task descriptions, student submissions, VPL files, and quiz grades.
  • RubricParser: Extracts grading criteria from task descriptions to facilitate AI grading.
  • AIGrader: Evaluates student submissions based on the extracted rubric criteria and provides grades.
  • SubmissionCache: Smart caching system that tracks all submissions and only processes new or modified ones.
  • Quiz Reports: Generate comprehensive reports of quiz grades with statistics.

Supported Activity Types

  • ✅ Assignments (mod_assign): Regular file submissions
  • ✅ VPL (Virtual Programming Lab): Code submissions with automatic compilation
  • ✅ Quizzes (mod_quiz): Quiz attempts and grades with detailed statistics

Documentation

  • 📚 - Sistema de caché y detección de cambios
  • 📝 - Funcionalidad de quizzes y reportes

Testing

To run the tests, use the following command:

pytest tests/

Contributing

Contributions are welcome! Please submit a pull request or open an issue for any enhancements or bug fixes.

License

This project is licensed under the MIT License.