Moodle MCP Server
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 cursoMuestra 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 cursoIncluye 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íficaRequiere el ID de la tarea y, opcionalmente, el ID del estudiante.
provide_assignment_feedback: proporciona calificaciones y comentarios para la entrega de un estudianteRequiere 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 cursoIncluye 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íficaRequiere el ID del cuestionario y, opcionalmente, el ID del estudiante.
provide_quiz_feedback: proporciona comentarios para un intento de cuestionarioRequiere 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
Clonar este repositorio:
git clone https://github.com/your-username/moodle-mcp-server.git
cd moodle-mcp-serverInstalar dependencias:
npm installCree un archivo
.envcon 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 IDConstruir el servidor:
npm run buildUso 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 watchDepuració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 inspectorEl 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
.envni su token de API de MoodleAsegú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
Available Tools
7 toolsget_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
Scored across 7 tools
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.
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.
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.
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
Related MCP Connectors
MCP server for AI dialogue using various LLM models via AceDataCloud
An MCP server that provides an API to LLMs to manage their JumpCloud resources.
MCP server unifying ERPs, CRMs, APIs and knowledge base for Claude, ChatGPT and Gemini.
Related MCP Servers
- AlicenseBqualityDmaintenanceAn MCP server that enables LLMs to interact with the Moodle platform to manage courses, students, assignments, and quizzes.7MIT
- AlicenseNot gradedqualityDmaintenanceA Moodle MCP server so students can collaborate with their courses through the LLM tools.1MIT
- AlicenseAqualityDmaintenanceMCP server that connects AI assistants to Instructure Canvas LMS, enabling teachers and administrators to manage courses, assignments, grades, and more through natural language.8030 npm1MIT
- AlicenseNot gradedqualityDmaintenanceA powerful Model Context Protocol (MCP) server that seamlessly integrates AI assistants with Moodle Learning Management System. Enable your AI assistant to access courses, retrieve educational content, download resources, and search through your learning materials.1MIT