EduBase MCP Server

oficial

Interactúa con EduBase, una plataforma integral de e-learning con capacidades avanzadas de cuestionarios, gestión de exámenes y organización de contenido.

GitHub

Documentación

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 clientes MCP (por ejemplo, Claude Desktop) y LLMs interactúen con tu cuenta de EduBase y realicen tareas en tu nombre. Soporta los protocolos de transporte stdio, SSE y HTTP transmitible.

EduBase MCP demo GIF: Claude uploads math questions

¿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 funcionalidades:

Sistema Avanzado de Cuestionarios con parametrización que permite infinitas variaciones de la misma pregunta, detección de copia 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 funcionalidades como integración SSO, controles de acceso detallados, auditoría integral y cumplimiento con el RGPD
Integración con tus sistemas existentes mediante LTI, API completa y opciones de integración personalizadas
Herramientas Asistidas por IA, como EduBase Assistant, 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:

Demonstrating EduBase's MCP server to collaboratively create and upload questions, schedule exams and analyze results.

Obtención de tus credenciales API

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

Si no ves esta opción, introduce el código de activación MCPGITHUB o no dudes en contactarnos para solicitar acceso en [email protected].

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 mediante 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 App ID 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 App ID 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 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`

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, debes configurar el servidor con EDUBASE_API_APP y EDUBASE_API_KEY también!
Con autenticación de token de portador (Bearer): 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 App ID 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 autoaprovisionada, creada en el primer consentimiento. Sin App ID/Secreto que copiar — los usuarios solo hacen clic en "Conectar EduBase" en su cliente.

Uso con Claude Desktop

Para una guía 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 (sustituye por 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 mediante 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 mediante Smithery

Para instalar el servidor MCP de EduBase para Claude Desktop automáticamente a través de 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: [email protected]