EduBase

Servidor MCP de EduBase

Este repositorio contiene la implementación del Protocolo de Contexto de Modelo (MCP) como servidor para la plataforma EduBase. Permite que los clientes MCP (por ejemplo, Claude Desktop) y los LLM interactúen con tu cuenta de EduBase y realicen tareas en tu nombre. Admite los protocolos de transporte stdio, SSE y HTTP transmisible.

¿Qué es EduBase?

EduBase es una plataforma educativa en línea, innovadora, modular e interactiva que hace que el aprendizaje sea más agradable, sencillo e interactivo, adecuada para instituciones educativas o empresas.

¿Por qué elegir EduBase?

EduBase revoluciona el aprendizaje digital con su combinación única de funciones:

• Sistema de Cuestionarios Avanzado con parametrización que permite variaciones infinitas de una misma pregunta, detección de trampas en tiempo real, composición tipográfica LaTeX de alta calidad, soporte avanzado para STEM y calificación automática
• Entorno de Aprendizaje Unificado que centraliza todo tu contenido educativo — videos, exámenes, documentos y módulos SCORM — en un solo sistema intuitivo
• Seguridad de Nivel Empresarial con funciones como integración SSO, controles de acceso detallados, auditoría integral y cumplimiento de GDPR
• Integración con tus sistemas existentes mediante LTI, API integral y opciones de integración personalizadas
• Herramientas Asistidas por IA, como el Asistente de EduBase, que pueden transformar instantáneamente tu contenido existente en cuestionarios y evaluaciones interactivas, o traducir tus materiales de un idioma a otro

Desde instituciones de educación superior hasta departamentos de capacitación corporativa, EduBase se adapta a tus necesidades específicas mientras mantiene una experiencia de usuario intuitiva en todos los dispositivos.

Video de demostración

Creación y carga colaborativa de preguntas, programación de exámenes y análisis de resultados de usuarios con Claude:

Obtención de tus credenciales de API

Una vez que hayas iniciado sesión, en tu Panel de control, busca el menú de Integraciones, haz clic en "agregar integración" y elige el tipo "API de EduBase".

Si no ves esta opción, ingresa el código de activación MCPGITHUB o contáctanos para solicitar acceso en info@edubase.net.

Herramientas

Cada endpoint de API documentado está disponible como una herramienta, denominada edubase_<method>_<endpoint>. Por ejemplo, la herramienta para el endpoint GET /user:me se llama edubase_get_user_me. Los endpoints de etiquetas, permisos y transferencias funcionan de la misma manera para cada tipo de contenido, por lo que comparten una sola herramienta por método con un argumento type (por ejemplo, edubase_post_content_tag para POST /exam:tag, POST /quiz:tag, etc.). Consulta nuestra documentación para desarrolladores para obtener más información.

Conjuntos de herramientas

Las herramientas se agrupan en conjuntos de herramientas, para que puedas exponer solo las herramientas que necesitas. Menos herramientas utilizan menos contexto del modelo y facilitan que el modelo elija la correcta. Cada conjunto de herramientas está habilitado de forma predeterminada.

Conjunto de herramientas	Herramientas para
files	Cargas de archivos temporales (siempre habilitado)
questions	Preguntas
quizzes	Conjuntos de cuestionarios, sus preguntas, configuraciones y ajustes de calificación
exams	Exámenes, sus configuraciones, usuarios, certificados y marca
results	Resultados de cuestionarios y exámenes, descargas de certificados
users	Usuarios, sus nombres, grupos y enlaces de inicio de sesión
classes	Clases y membresías de clases
organizations	Organizaciones, miembros, departamentos, competencias y webhooks
integrations	Integraciones y sus claves
tags	Etiquetas y adjuntos de etiquetas de contenidos
permissions	Permisos de usuarios sobre contenidos y transferencias de propiedad
metrics	Métricas personalizadas

Selecciona conjuntos de herramientas con una lista separada por comas en EDUBASE_TOOLSETS (por ejemplo, questions,quizzes,exams). Establece EDUBASE_READONLY=true para exponer solo las herramientas que leen datos (las herramientas get y las herramientas que solo generan enlaces de descarga, como edubase_post_question_export).

Establece EDUBASE_DYNAMIC_TOOLSETS=true para habilitar conjuntos de herramientas bajo demanda: las sesiones comienzan solo con las herramientas críticas, y el modelo habilita los conjuntos de herramientas que necesita con la herramienta edubase_enable_toolsets (listada con edubase_list_toolsets). Esto mantiene la lista inicial de herramientas pequeña para los clientes que cargan todas las herramientas de antemano, pero necesita un cliente que actualice la lista de herramientas cuando se le notifique sobre cambios.

Cuando se utiliza un transporte HTTP, los clientes pueden reducir aún más la configuración para su propia sesión con los encabezados EduBase-Mcp-Toolsets, EduBase-Mcp-ReadOnly y EduBase-Mcp-Dynamic, o los parámetros de consulta toolsets, read_only y dynamic_toolsets (por ejemplo, https://domain.edubase.net/mcp?toolsets=exams&read_only=true). Una sesión nunca puede habilitar conjuntos de herramientas o herramientas de escritura que la configuración del servidor deshabilite.

Configuración

El servidor MCP se puede configurar mediante variables de entorno. Las siguientes variables están disponibles:

Variable	Descripción	Requerida	Valor predeterminado
EDUBASE_API_URL	La URL base de la API de EduBase, muy probablemente https://subdomain.edubase.net/api.	Sí	https://www.edubase.net/api
EDUBASE_API_APP	El ID de aplicación de tu aplicación de integración en EduBase, el app en la API de EduBase. Encuéntralo en la ventana de detalles de integración en EduBase.	No si se usa transporte HTTP con autenticación; de lo contrario, Sí	-
EDUBASE_API_KEY	La clave secreta de tu aplicación de integración en EduBase, el secret en la API de EduBase. Encuéntrala junto al ID de aplicación en la ventana de detalles de integración en EduBase.	No si se usa transporte HTTP con autenticación; de lo contrario, Sí	-
EDUBASE_SSE_MODE	Inicia el servidor MCP en modo HTTP con transporte SSE. El valor debe ser true.	No	false
EDUBASE_STREAMABLE_HTTP_MODE	Inicia el servidor MCP en modo HTTP con transporte HTTP transmisible. El valor debe ser true.	No	false
EDUBASE_TOOLSETS	Lista separada por comas de los conjuntos de herramientas habilitados, o all.	No	all
EDUBASE_READONLY	Solo expone las herramientas que leen datos. El valor debe ser true.	No	false
EDUBASE_OUTPUT_SCHEMAS	Esquemas de salida de las herramientas y resultados estructurados de herramientas: off lista las herramientas sin esquemas de salida y devuelve los resultados solo como texto JSON, on incluye los esquemas de salida completos, fields incluye los esquemas de salida sin las descripciones de campos (manteniendo los resultados estructurados, pero ahorrando la mayoría de los tokens de los esquemas).	No	fields
EDUBASE_CONFIG_PROVIDERS	Lista separada por comas de los proveedores de alojamiento autorizados para suministrar la configuración de sesión en las solicitudes cuando se utiliza un transporte HTTP. Actualmente solo se admite smithery (el parámetro de consulta config codificado en base64).	No	-
EDUBASE_DYNAMIC_TOOLSETS	Inicia sesiones solo con las herramientas de carga de archivos y permite que el modelo habilite conjuntos de herramientas bajo demanda. El valor debe ser true.	No	false
EDUBASE_HTTP_PORT	El servidor HTTP escuchará en este puerto si se utiliza el modo de transporte SSE o HTTP transmisible.	No	3000
EDUBASE_OAUTH	Habilita el comportamiento de recurso protegido OAuth 2.1: las solicitudes no autenticadas se rechazan con 401 + WWW-Authenticate apuntando a /.well-known/oauth-protected-resource, y los tokens de portador se reenvían a la API de EduBase.	No	false
EDUBASE_OAUTH_AUTHORIZATION_SERVER	URL base pública de la implementación de EduBase que actúa como IdP de OAuth. Se utiliza para anunciar el servidor de autorización en el documento de metadatos del recurso protegido.	No	derivada de EDUBASE_API_URL
EDUBASE_OAUTH_RESOURCE_URL	URL base pública de este servidor MCP (el indicador de recurso de OAuth). Se utiliza en el encabezado WWW-Authenticate y en los metadatos del recurso.	No	derivada de EDUBASE_API_URL
EDUBASE_ALLOW_PRIVATE_NETWORK	Cuando se utiliza un transporte HTTP, la herramienta edubase_filebin bloquea solicitudes salientes a direcciones privadas, de bucle local, de enlace local y reservadas (protección SSRF) y rechaza rutas de archivos locales. Establece true para permitirlas, por ejemplo, una implementación autoalojada en una red privada confiable. No tiene efecto en modo stdio, donde el usuario local es el único llamador.	No	false
EDUBASE_FILEBIN_ALLOWED_HOSTS	Lista opcional separada por comas de nombres de host permitidos como destinos de carga de edubase_filebin (host exacto o cualquier subdominio, por ejemplo, edubase.net). Cuando está vacía, se permite cualquier host público (aún sujeto al filtrado de direcciones anterior).	No	-

Uso como servidor MCP remoto

Puedes usar el servidor MCP de EduBase como servidor MCP remoto para tu cliente MCP. Para hacerlo, necesitas alojar el servidor MCP donde los clientes puedan acceder a él, y luego configurar el cliente para conectarse al servidor. Inícialo con modo de transporte SSE o HTTP transmisible y usa siempre HTTPS al acceder al servidor de forma remota a través de internet.

Autenticación con servidores remotos

Puedes usar el servidor en dos modos:

• Sin autenticación del cliente: En este modo, el servidor no requerirá ninguna autenticación del cliente. Esto es útil para fines de prueba o desarrollo, o en una red cerrada, pero no se recomienda para uso en producción. Para esto, debes configurar el servidor con EDUBASE_API_APP y EDUBASE_API_KEY también.
• Con autenticación de token de portador: En este modo, el servidor requerirá que se envíe un token de portador con cada solicitud. Esta es la forma recomendada de usar el servidor en producción. Puedes obtener el token de portador de tu cuenta de EduBase creando una aplicación de integración y proporcionando el ID de aplicación y la clave secreta en el formato {app}:{secret}, codificados en base64 como token. El servidor usará este token para autenticar al cliente y autorizar el acceso a los endpoints de la API.
• Con OAuth 2.1 (EduBase como IdP): Cuando EDUBASE_OAUTH=true, los clientes compatibles (Claude Desktop, conectores de Claude.ai, Cursor, conectores de ChatGPT, etc.) descubren el servidor de autorización de EduBase a través de /.well-known/oauth-protected-resource, se registran dinámicamente (RFC 7591), guían al usuario a través de una pantalla de consentimiento de EduBase e intercambian un código de autorización (con PKCE S256) por un token de acceso opaco. El servidor MCP reenvía ese token tal cual a la API de EduBase, que lo resuelve a la integración MCP aprovisionada automáticamente, creada en el primer consentimiento. Sin ID de aplicación/Clave secreta para copiar — los usuarios solo hacen clic en "Conectar EduBase" en su cliente.

Uso con Claude Desktop

Para obtener una guía paso a paso, consulta nuestra publicación de blog sobre cómo conectar EduBase con Claude: La Guía Completa de Integración MCP.

Uso del servidor MCP de EduBase proporcionado

Puedes usar el servidor MCP de EduBase proporcionado (si está disponible) sin ninguna configuración, solo agregándolo como servidor remoto en tu cliente con la URL https://domain.edubase.net/mcp (reemplázala con el dominio real), si admite autenticación OAuth, o con el token de portador apropiado en el encabezado Authorization (Authorization: Bearer ${BASE64_ENCODED_TOKEN}).

Recomendado para usuarios de www.edubase.net, ya que el servidor es mantenido y actualizado por nosotros, y no tienes que preocuparte por alojarlo o configurarlo. Solo asegúrate de usar la URL y el método de autenticación correctos al conectar tu cliente.

Instalación manual

Agrega lo siguiente a tu claude_desktop_config.json:

Usando Node.js

Antes de ejecutar el servidor MCP, asegúrate de tener Node.js instalado. Puedes descargarlo desde nodejs.org o usar un administrador de paquetes como brew.

{
  "mcpServers": {
    "edubase": {
      "command": "npx",
      "args": [
        "-y",
        "@edubase/mcp"
      ],
      "env": {
        "EDUBASE_API_URL": "https://domain.edubase.net/api",
        "EDUBASE_API_APP": "your_integration_app_id",
        "EDUBASE_API_KEY": "your_integration_secret_key"
      }
    }
  }
}

O descarga la versión del servidor MCP de EduBase o clona el repositorio y ejecuta npm run build para compilar el servidor. No olvides ajustar /path/to/dist al directorio real y configurar las variables de entorno.

{
  "mcpServers": {
    "edubase": {
      "command": "node",
      "args": [
        "/path/to/dist/index.js"
      ],
      "env": {
        "EDUBASE_API_URL": "https://domain.edubase.net/api",
        "EDUBASE_API_APP": "your_integration_app_id",
        "EDUBASE_API_KEY": "your_integration_secret_key"
      }
    }
  }
}

Usando Docker

Antes de ejecutar el servidor MCP, asegúrate de tener Docker instalado y en ejecución. Puedes descargarlo desde docker.com o usar un administrador de paquetes. No olvides configurar las variables de entorno.

{
  "mcpServers": {
    "edubase": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "EDUBASE_API_URL",
        "-e",
        "EDUBASE_API_APP",
        "-e",
        "EDUBASE_API_KEY",
        "edubase/mcp"
      ],
      "env": {
        "EDUBASE_API_URL": "https://domain.edubase.net/api",
        "EDUBASE_API_APP": "your_integration_app_id",
        "EDUBASE_API_KEY": "your_integration_secret_key"
      }
    }
  }
}

Instalación mediante servidor MCP remoto

Puede utilizar el servidor MCP de EduBase proporcionado (si está disponible) como servidor remoto. Recomendamos codificar en Base64 su EDUBASE_API_APP y EDUBASE_API_KEY y usarlo como token Bearer en el encabezado Authorization (Authorization: Bearer ${BASE64_ENCODED_TOKEN}).

{
  "mcpServers": {
    "edubase": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://domain.edubase.net/mcp",
        "--header",
        "Authorization: Bearer ${EDUBASE_API_APP}:${EDUBASE_API_KEY}"
      ]
    }
  }
}

Instalación mediante Smithery

Para instalar el servidor MCP de EduBase para Claude Desktop automáticamente mediante Smithery:

npx -y @smithery/cli install @EduBase/MCP --client claude

Desarrollo

Ejecute npm test para compilar el servidor y comprobar el listado de herramientas: los presupuestos de tamaño de la lista de herramientas y las instrucciones del servidor, las descripciones de las herramientas, el conjunto de herramientas, los modos de conjuntos de herramientas de solo lectura y dinámicos, y el manejo de configuración del transporte HTTP. Cuando nuevas herramientas superen un presupuesto, acorte sus esquemas o aumente el presupuesto en test/server.test.mjs deliberadamente, ya que cada cliente paga por la lista de herramientas en cada sesión.

Contacto

Sitio web: www.edubase.net
Documentación para desarrolladores: developer.edubase.net
Correo electrónico: info@edubase.net