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.

Requisitos

Node.js (v14 o superior)
Token de API de Moodle con permisos adecuados
ID del curso Moodle

Instalación

Clonar este repositorio:

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

Instalar dependencias:

npm install

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

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

Inicie sesión en su sitio Moodle como administrador
Vaya a Administración del sitio > Complementos > Servicios web > Administrar tokens
Crea un nuevo token con los permisos necesarios para administrar cursos
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)

Moodle MCP Server

Integrations