EduBase

Servidor MCP de EduBase

Este repositorio contiene la implementación del Protocolo de Contexto de Modelo (MCP) para la plataforma EduBase. Permite a los clientes MCP (por ejemplo, Claude Desktop) y a los LLM interactuar con tu cuenta de EduBase y realizar tareas en tu nombre. Soporta los protocolos de transporte stdio, SSE y HTTP transmitible.

¿Qué es EduBase?

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

¿Por qué elegir EduBase?

EduBase revoluciona el aprendizaje digital con su combinación única de características:

• Sistema Avanzado de Cuestionarios con parametrización que permite infinitas variaciones de la misma pregunta, detección de trampas en tiempo real, composición tipográfica LaTeX de alta calidad, soporte STEM avanzado y calificación automática
• Entorno de Aprendizaje Unificado que centraliza todo tu contenido educativo — vídeos, exámenes, documentos y módulos SCORM — en un sistema intuitivo
• Seguridad de Nivel Empresarial con características como integración SSO, controles de acceso detallados, auditoría integral y cumplimiento del RGPD
• Integración con tus sistemas existentes a través de 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 formación corporativa, EduBase se adapta a tus necesidades específicas manteniendo una experiencia de usuario intuitiva en todos los dispositivos.

Vídeo 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 API

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

Si no ves esta opción, introduce el código de activación MCPGITHUB o no dudes en contactarnos para solicitar acceso en info@edubase.net.

Herramientas

Cada endpoint documentado de la API está disponible como una herramienta separada, nombrada edubase_<method>_<endpoint>. Por ejemplo, la herramienta para el endpoint GET /user:me se llama edubase_get_user_me. Consulta nuestra documentación para desarrolladores para más información.

Configuración

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

Variable	Descripción	Requerida	Valor por defecto
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 App 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, la secret en la API de EduBase. Encuéntrala junto al ID de App 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	Iniciar el servidor MCP en modo HTTP con transporte SSE. El valor debe ser true.	No	false
EDUBASE_STREAMABLE_HTTP_MODE	Iniciar el servidor MCP en modo HTTP con transporte HTTP transmitible. El valor debe ser true.	No	false
EDUBASE_HTTP_PORT	El servidor HTTP escuchará en este puerto si se usa el modo de transporte SSE o HTTP transmitible.	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 del despliegue de EduBase que actúa como el IdP de OAuth. Se usa 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 OAuth). Se usa en la cabecera WWW-Authenticate y en los metadatos del recurso.	No	derivada de EDUBASE_API_URL
EDUBASE_ALLOW_PRIVATE_NETWORK	Cuando se usa un transporte HTTP, la herramienta edubase_filebin bloquea las solicitudes salientes a direcciones privadas, de bucle local, de enlace local y reservadas (protección SSRF) y rechaza las rutas de archivos locales. Establécelo en true para permitirlas, por ejemplo, en un despliegue autoalojado en una red privada de confianza. No tiene efecto en modo stdio, donde el usuario local es el único llamante.	No	false
EDUBASE_FILEBIN_ALLOWED_HOSTS	Lista opcional separada por comas de nombres de host permitidos como destinos de carga 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 un servidor MCP remoto para tu cliente MCP. Para ello, necesitas alojar el servidor MCP donde los clientes puedan acceder a él, y luego configurar el cliente para que se conecte al servidor. ¡Inícialo con modo de transporte SSE o HTTP transmitible 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 de cliente: En este modo, el servidor no requerirá ninguna autenticación del cliente. Esto es útil para pruebas o desarrollo, o en una red cerrada, pero no se recomienda para uso en producción. ¡Para esto, tienes que 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 App y la clave secreta en el formato {app}:{secret}, codificado en base64 como un token. El servidor usará entonces 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 textualmente a la API de EduBase, que lo resuelve a la integración MCP aprovisionada automáticamente, creada en el primer consentimiento. Sin ID de App/Secreto que copiar — los usuarios solo hacen clic en "Conectar EduBase" en su cliente.

Uso con Claude Desktop

Para un recorrido paso a paso, consulta nuestra entrada de blog sobre cómo conectar EduBase con Claude: La Guía Completa de Integración MCP.

Usando el servidor MCP de EduBase proporcionado

Puedes usar el servidor MCP de EduBase proporcionado (si está disponible) sin ninguna configuración, simplemente añadiéndolo como un servidor remoto en tu cliente con la URL https://domain.edubase.net/mcp (reemplázala con el dominio real), si soporta autenticación OAuth, o con el token de portador apropiado en la cabecera 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

Añade 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 gestor 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 construir 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 funcionamiento. Puedes descargarlo desde docker.com o usar un gestor 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 vía servidor MCP remoto

Puedes usar el servidor MCP de EduBase proporcionado (si está disponible) como un servidor remoto. Recomendamos codificar en Base64 tu EDUBASE_API_APP y EDUBASE_API_KEY y usarlo como un token de portador en la cabecera 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 vía Smithery

Para instalar el servidor MCP de EduBase para Claude Desktop automáticamente vía Smithery:

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

Contacto

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