Skip to main content
Glama

Servidor Moodle MCP

Un servidor MCP (Protocolo de contexto de modelo) que permite a los LLM interactuar con la plataforma Moodle para administrar cursos, estudiantes, tareas y exámenes.

Características

Herramientas de gestión de estudiantes

  • list_students - Recupera la lista de estudiantes inscritos en el curso

    • Muestra la identificación, el nombre, el correo electrónico y la última hora de acceso de cada estudiante.

Herramientas de gestión de tareas

  • get_assignments - Recupera todas las tareas disponibles en el curso

    • Incluye información como identificación, nombre, descripción, fecha de vencimiento y calificación máxima.

  • get_student_submissions : examina las entregas de un estudiante para una tarea específica

    • Requiere el ID de la tarea y, opcionalmente, el ID del estudiante.

  • provide_assignment_feedback : proporciona calificaciones y comentarios para la entrega de un estudiante

    • Requiere identificación del estudiante, identificación de la tarea, calificación y comentario de retroalimentación.

Herramientas de gestión de cuestionarios

  • get_quizzes - Recupera todos los cuestionarios disponibles en el curso

    • Incluye información como identificación, nombre, descripción, fechas de apertura/cierre y calificación máxima.

  • get_quiz_attempts : examina los intentos de un estudiante en una prueba específica

    • Requiere el ID del cuestionario y, opcionalmente, el ID del estudiante.

  • provide_quiz_feedback : proporciona comentarios para un intento de cuestionario

    • Requiere el ID del intento y el comentario de retroalimentación.

Related MCP server: Moodle MCP

Requisitos

  • Node.js (v14 o superior)

  • Token de API de Moodle con permisos adecuados

  • ID del curso Moodle

Instalación

  1. Clonar este repositorio:

git clone https://github.com/your-username/moodle-mcp-server.git
cd moodle-mcp-server
  1. Instalar dependencias:

npm install
  1. Cree un archivo .env con la siguiente configuración:

MOODLE_API_URL=https://your-moodle.com/webservice/rest/server.php
MOODLE_API_TOKEN=your_api_token
MOODLE_COURSE_ID=1  # Replace with your course ID
  1. Construir el servidor:

npm run build

Uso con Claude

Para utilizar con Claude Desktop, agregue la configuración del servidor:

En MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
En Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "moodle-mcp-server": {
      "command": "/path/to/node",
      "args": [
        "/path/to/moodle-mcp-server/build/index.js"
      ],
      "env": {
        "MOODLE_API_URL": "https://your-moodle.com/webservice/rest/server.php",
        "MOODLE_API_TOKEN": "your_moodle_api_token",
        "MOODLE_COURSE_ID": "your_course_id"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

Para los usuarios de Windows, las rutas utilizarían barras invertidas:

{
  "mcpServers": {
    "moodle-mcp-server": {
      "command": "C:\\path\\to\\node.exe",
      "args": [
        "C:\\path\\to\\moodle-mcp-server\\build\\index.js"
      ],
      "env": {
        "MOODLE_API_URL": "https://your-moodle.com/webservice/rest/server.php",
        "MOODLE_API_TOKEN": "your_moodle_api_token",
        "MOODLE_COURSE_ID": "your_course_id"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

Una vez configurado, Claude podrá interactuar con tu curso Moodle para:

  • Ver la lista de estudiantes y sus entregas

  • Proporcionar comentarios y calificaciones para las tareas.

  • Examinar los intentos de prueba y ofrecer comentarios.

Desarrollo

Para desarrollo con reconstrucción automática:

npm run watch

Depuración

Los servidores MCP se comunican a través de stdio, lo que puede dificultar la depuración. Recomendamos usar el Inspector MCP :

npm run inspector

El Inspector proporcionará una URL para acceder a las herramientas de depuración en su navegador.

Obtener un token de API de Moodle

  1. Inicie sesión en su sitio Moodle como administrador

  2. Vaya a Administración del sitio > Complementos > Servicios web > Administrar tokens

  3. Crea un nuevo token con los permisos necesarios para administrar cursos

  4. Copia el token generado y agrégalo a tu archivo .env

Seguridad

  • Nunca comparta su archivo .env ni su token de API de Moodle

  • Asegúrese de que el servidor MCP solo tenga acceso a los cursos que necesita administrar

  • Utilice un token con los permisos mínimos necesarios

Licencia

Instituto Tecnológico de Massachusetts (MIT)

Available Tools

7 tools
get_assignmentsB

Obtiene la lista de tareas asignadas en el curso configurado

Inputs: no named parameters.

get_quiz_gradeB

Obtiene la calificación de un estudiante en un quiz específico

Inputs: studentId (required), quizId (required).

get_quizzesB

Obtiene la lista de quizzes en el curso configurado

Inputs: no named parameters.

get_studentsB

Obtiene la lista de estudiantes inscritos en el curso configurado

Inputs: no named parameters.

get_submission_contentC

Obtiene el contenido detallado de una entrega específica, incluyendo texto y archivos adjuntos

Inputs: studentId (required), assignmentId (required).

get_submissionsC

Obtiene las entregas de tareas en el curso configurado

Inputs: studentId, assignmentId.

provide_feedbackC

Proporciona feedback sobre una tarea entregada por un estudiante

Inputs: studentId (required), assignmentId (required), feedback (required), grade.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.3/5.0

    Scored across 7 tools

    Disambiguation4/5

    The tools are mostly distinct with clear purposes: get_assignments, get_quizzes, get_students, get_submissions, and get_submission_content target different resources, while get_quiz_grade and provide_feedback focus on specific actions. However, get_submissions and get_submission_content could be slightly confusing as they both relate to submissions, though their descriptions clarify the difference between listing submissions and getting detailed content.

    Naming Consistency5/5

    All tool names follow a consistent verb_noun pattern using snake_case, starting with 'get_' for retrieval operations and 'provide_' for the feedback action. This uniformity makes the tool set predictable and easy to understand, with no deviations in naming conventions.

    Tool Count4/5

    With 7 tools, the count is reasonable for a Moodle server focused on course management. It covers key areas like assignments, quizzes, students, and submissions, though it might be slightly thin for broader educational workflows, such as missing tools for creating or updating resources.

    Completeness3/5

    The tool set provides good read-only coverage for retrieving course data (assignments, quizzes, students, submissions) and includes a feedback action. However, there are notable gaps in CRUD operations: no tools for creating, updating, or deleting resources (e.g., assignments or quizzes), which limits agent functionality for full lifecycle management in the Moodle domain.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers