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: mcp-server-llmling

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

2. Instalar dependencias:

npm install

3. 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

4. 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)