Skip to main content
Glama
moodleMCP

Moodle MCP Server

by moodleMCP

moodle-mcp

Servidor MCP (Model Context Protocol) para exponer tools que permiten a un LLM interactuar con Moodle mediante su API REST.

Estado: baseline listo para producción ligera (TypeScript + Fastify). Incluye validación con Zod, logging con Pino, estructura de acciones y cliente REST con backoff.

Requisitos

  • Node.js 20+

  • Token de servicio en Moodle (REST)

  • URL base de Moodle (p. ej. https://elearning.org)

Related MCP server: moodle-mcp

Configuración

  1. Copia .env.example a .env y ajusta valores:

MOODLE_BASE_URL=https://elearning.example.org
MOODLE_TOKEN=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
MOODLE_FORMAT=json
PORT=7410
LOG_LEVEL=info
  1. Instala dependencias:

npm install
  1. Arranca en modo desarrollo:

npm run dev

El servidor expone:

  • GET /healthok

  • POST /mcp/tools → invocar tools MCP con payload { tool, arguments }

  • GET /mcp/resources/:type/:id → recursos cacheables (course, user, assignment)

Ejemplos de uso

Listar cursos:

curl -X POST http://localhost:7410/mcp/tools   -H "content-type: application/json"   -d '{"tool":"list_courses","arguments":{"search":"prospectiva","limit":10}}'

Buscar usuario por email:

curl -X POST http://localhost:7410/mcp/tools   -H "content-type: application/json"   -d '{"tool":"get_user_by_email","arguments":{"email":"alguien@org.org"}}'

Matricular usuario:

curl -X POST http://localhost:7410/mcp/tools   -H "content-type: application/json"   -d '{"tool":"enroll_user","arguments":{"userid":123,"courseid":456,"roleid":5}}'

Estructura

src/
  index.ts            # bootstrap Fastify
  mcpServer.ts        # registro y ruteo de tools/resources
  moodleClient.ts     # wrapper REST Moodle con backoff
  config.ts           # carga de env
  utils/
    validators.ts     # esquemas Zod
    error.ts          # tipos/ayudantes de error
    logging.ts        # logger Pino
  actions/            # handlers MCP
    courses.ts
    users.ts
    enrollments.ts
    assignments.ts
    forums.ts
    files.ts
    quizzes.ts
schemas/              # (espacio para JSON Schemas si los separas)
test/
  params.test.ts      # tests de flatten/validación
mcp.json              # manifest MCP

Notas sobre Moodle REST

  • Endpoint: {MOODLE_BASE_URL}/webservice/rest/server.php

  • Parámetros obligatorios: wstoken, wsfunction, moodlewsrestformat

  • Codificación de arrays: courseids[0]=123&courseids[1]=456 (ya soportado por flattenParams).

  • Errores: el cliente normaliza errores HTTP/REST y texto de Moodle.

Docker

docker build -t moodle-mcp .
docker run --env-file .env -p 7410:7410 moodle-mcp

Licencia

MIT © 2025

Related MCP Connectors

  • AXL MCP lets AI assistants create and manage landing pages, courses, email campaigns, CRM records, and marketing workflows inside AXL. Built for growing expert businesses, it turns chat requests into real work across sales, marketing, and course delivery. An AXL account is required. Sign in securely with OAuth 2.1. Website: https://axl.tech/developers/mcp . Setup guide: https://docs.axl.tech/mcp . Watch AXL in 77 seconds: pages, courses, CRM, and automation. Product overview: https://www.youtube.com/watch?v=jlhR9CafIww

  • Enable Large Language Model clients to interact seamlessly with any MediaWiki wiki. Perform action…

  • Manage your Hovercode QR codes, short links, landing pages, and forms by chatting. Create and restyle QR codes, retarget printed dynamic codes without reprinting, host PDFs behind a QR, build landing pages and forms, organise with folders and tags, and read scan analytics. Hosted, OAuth, works with Claude, ChatGPT, Cursor, and any MCP client.

  • Carbon Voice MCP serves as a bridge that connects AI assistants like ChatGPT, Claude, and Cursor to a user's Carbon Voice account, turning voice messages and conversations into a private, on-demand knowledge base. It provides 28 specialized tools for comprehensive voice messaging management, including creating and sending messages, accessing conversation history with instant transcription, running AI actions (summarization, TLDR generation, meeting notes), and managing workspace collaboration through folders, contacts, and team communications.

Related MCP Servers

  • A
    license
    Not graded
    quality
    D
    maintenance
    Enables interaction with Moodle learning management systems through the REST API. Supports course management, user enrollment, assignment handling, and forum operations through natural language.
    190 npm
    MIT
  • A
    license
    Not graded
    quality
    C
    maintenance
    Provides Claude with full access to Moodle learning management systems, enabling interaction with courses, files, assignments, grades, and calendar events. It also supports building Obsidian study vaults from course materials through automated knowledge graph creation.
    190 npm
    17
    MIT