EduBase

EduBase MCP-сервер

Этот репозиторий содержит реализацию Model Context Protocol (MCP) сервера для платформы EduBase. Он позволяет MCP-клиентам (например, Claude Desktop) и LLM взаимодействовать с вашей учетной записью EduBase и выполнять задачи от вашего имени. Поддерживаются транспортные протоколы stdio, SSE и streamable HTTP.

Что такое EduBase?

EduBase — это инновационная, модульная, онлайн-образовательная платформа, которая делает обучение более увлекательным, простым и интерактивным, подходящая для образовательных учреждений или предприятий.

Почему стоит выбрать EduBase?

EduBase революционизирует цифровое обучение благодаря уникальному сочетанию функций:

• Продвинутая система тестов с параметризацией, позволяющей создавать бесконечные вариации одного и того же вопроса, обнаружением списывания в реальном времени, красивым набором формул LaTeX, расширенной поддержкой STEM и автоматической оценкой
• Единая среда обучения, которая централизует весь ваш образовательный контент — видео, экзамены, документы и SCORM-модули — в одной интуитивно понятной системе
• Безопасность корпоративного уровня с такими функциями, как интеграция SSO, детальный контроль доступа, всесторонний аудит и соответствие GDPR
• Интеграция с вашими существующими системами через LTI, комплексный API и возможности пользовательской интеграции
• Инструменты на базе ИИ, такие как EduBase Assistant, которые могут мгновенно преобразовать ваш существующий контент в интерактивные викторины и тесты или перевести ваши материалы с одного языка на другой

От высших учебных заведений до корпоративных отделов обучения — EduBase масштабируется в соответствии с вашими конкретными потребностями, сохраняя при этом интуитивно понятный пользовательский интерфейс на всех устройствах.

Демонстрационное видео

Совместное создание и загрузка вопросов, планирование экзаменов и анализ результатов пользователей с помощью Claude:

Получение учетных данных API

После входа в систему на панели управления найдите меню «Интеграции», нажмите «Добавить интеграцию» и выберите тип «EduBase API».

Если вы не видите эту опцию, введите код активации MCPGITHUB или свяжитесь с нами для запроса доступа по адресу info@edubase.net.

Инструменты

Каждая задокументированная конечная точка API доступна в виде отдельного инструмента с именем edubase_<method>_<endpoint>. Например, инструмент для конечной точки GET /user:me называется edubase_get_user_me. Дополнительные сведения см. в нашей документации для разработчиков.

Конфигурация

MCP-сервер можно настроить с помощью переменных окружения. Доступны следующие переменные:

Переменная	Описание	Обязательная	Значение по умолчанию
EDUBASE_API_URL	Базовый URL API EduBase, скорее всего https://subdomain.edubase.net/api.	Да	https://www.edubase.net/api
EDUBASE_API_APP	Идентификатор приложения (App ID) вашего интеграционного приложения в EduBase, app в API EduBase. Найдите его в окне сведений об интеграции в EduBase.	Нет, если используется HTTP-транспорт с аутентификацией, иначе Да	-
EDUBASE_API_KEY	Секретный ключ вашего интеграционного приложения в EduBase, secret в API EduBase. Найдите его вместе с App ID в окне сведений об интеграции в EduBase.	Нет, если используется HTTP-транспорт с аутентификацией, иначе Да	-
EDUBASE_SSE_MODE	Запустить MCP-сервер в режиме HTTP с транспортом SSE. Значение должно быть true.	Нет	false
EDUBASE_STREAMABLE_HTTP_MODE	Запустить MCP-сервер в режиме HTTP с потоковым HTTP-транспортом. Значение должно быть true.	Нет	false
EDUBASE_HTTP_PORT	HTTP-сервер будет слушать этот порт, если используется режим транспорта SSE или потокового HTTP.	Нет	3000
EDUBASE_OAUTH	Включает поведение защищенного ресурса OAuth 2.1: неаутентифицированные запросы отклоняются с 401 + WWW-Authenticate, указывающим на /.well-known/oauth-protected-resource, а токены-носители перенаправляются в API EduBase.	Нет	false
EDUBASE_OAUTH_AUTHORIZATION_SERVER	Публичный базовый URL развертывания EduBase, выступающего в качестве IdP OAuth. Используется для объявления сервера авторизации в документе метаданных защищенного ресурса.	Нет	определяется из EDUBASE_API_URL
EDUBASE_OAUTH_RESOURCE_URL	Публичный базовый URL этого MCP-сервера (индикатор ресурса OAuth). Используется в заголовке WWW-Authenticate и метаданных ресурса.	Нет	определяется из EDUBASE_API_URL
EDUBASE_ALLOW_PRIVATE_NETWORK	При использовании HTTP-транспорта инструмент edubase_filebin блокирует исходящие запросы к частным, loopback, link-local и зарезервированным адресам (защита от SSRF) и отказывается от локальных путей к файлам. Установите значение true, чтобы разрешить их, например, для самостоятельного развертывания в доверенной частной сети. Не действует в режиме stdio, где локальный пользователь является единственным вызывающим.	Нет	false
EDUBASE_FILEBIN_ALLOWED_HOSTS	Необязательный список разрешенных имен хостов через запятую, разрешенных в качестве целей загрузки edubase_filebin (точный хост или любой поддомен, например, edubase.net). Если пусто, разрешен любой публичный хост (все еще подлежит указанной выше фильтрации адресов).	Нет	-

Использование в качестве удаленного MCP-сервера

Вы можете использовать EduBase MCP-сервер как удаленный MCP-сервер для вашего MCP-клиента. Для этого вам необходимо разместить MCP-сервер там, где клиенты могут получить к нему доступ, а затем настроить клиент для подключения к серверу. Либо запустите его в режиме транспорта SSE или потокового HTTP и всегда используйте HTTPS при удаленном доступе к серверу через интернет!

Аутентификация с удаленными серверами

Вы можете использовать сервер в двух режимах:

• Без аутентификации клиента: В этом режиме сервер не будет требовать от клиента какой-либо аутентификации. Это полезно для тестирования или разработки, либо в закрытой сети, но не рекомендуется для промышленного использования. Для этого вы также должны настроить сервер с EDUBASE_API_APP и EDUBASE_API_KEY!
• С аутентификацией по токену-носителю (Bearer): В этом режиме сервер будет требовать отправки токена-носителя с каждым запросом. Это рекомендуемый способ использования сервера в промышленной среде. Вы можете получить токен-носитель из своей учетной записи EduBase, создав интеграционное приложение и указав App ID и Секретный ключ в формате {app}:{secret}, закодированном в base64 в виде токена. Затем сервер будет использовать этот токен для аутентификации клиента и авторизации доступа к конечным точкам API.
• С OAuth 2.1 (EduBase в качестве IdP): Когда EDUBASE_OAUTH=true, совместимые клиенты (Claude Desktop, коннекторы Claude.ai, Cursor, коннекторы ChatGPT и т.д.) обнаруживают сервер авторизации EduBase через /.well-known/oauth-protected-resource, регистрируются динамически (RFC 7591), проводят пользователя через экран согласия EduBase и обменивают код авторизации (с PKCE S256) на непрозрачный токен доступа. MCP-сервер перенаправляет этот токен дословно в API EduBase, который преобразует его в автоматически созданную MCP-интеграцию, созданную при первом согласии. Не нужно копировать App ID/Secret — пользователи просто нажимают «Подключить EduBase» в своем клиенте.

Использование с Claude Desktop

Пошаговое руководство см. в нашем блоге о том, как подключить EduBase к Claude: Полное руководство по интеграции MCP.

Использование предоставленного EduBase MCP-сервера

Вы можете использовать предоставленный EduBase MCP-сервер (если он доступен) без какой-либо настройки, просто добавив его как удаленный сервер в вашем клиенте с URL-адресом https://domain.edubase.net/mcp (замените на фактический домен), если он поддерживает аутентификацию OAuth, или с соответствующим токеном-носителем в заголовке Authorization (Authorization: Bearer ${BASE64_ENCODED_TOKEN}).

Рекомендуется для пользователей www.edubase.net, так как сервер поддерживается и обновляется нами, и вам не нужно беспокоиться о его размещении или настройке. Просто убедитесь, что используете правильный URL и метод аутентификации при подключении клиента.

Установка вручную

Добавьте следующее в ваш claude_desktop_config.json:

Использование Node.js

Перед запуском MCP-сервера убедитесь, что у вас установлен Node.js. Вы можете скачать его с nodejs.org или использовать менеджер пакетов, такой как 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"
      }
    }
  }
}

Или скачайте релиз EduBase MCP-сервера или клонируйте репозиторий и запустите npm run build для сборки сервера. Не забудьте изменить /path/to/dist на фактический каталог и настроить переменные окружения!

{
  "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"
      }
    }
  }
}

Использование Docker

Перед запуском MCP-сервера убедитесь, что у вас установлен и запущен Docker. Вы можете скачать его с docker.com или использовать менеджер пакетов. Не забудьте настроить переменные окружения!

{
  "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"
      }
    }
  }
}

Установка через удаленный MCP-сервер

Вы можете использовать предоставленный EduBase MCP-сервер (если он доступен) в качестве удаленного сервера. Мы рекомендуем закодировать ваш EDUBASE_API_APP и EDUBASE_API_KEY в Base64 и использовать их в качестве токена-носителя в заголовке 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}"
      ]
    }
  }
}

Установка через Smithery

Чтобы установить EduBase MCP-сервер для Claude Desktop автоматически через Smithery:

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

Контакты

Веб-сайт: www.edubase.net
Документация для разработчиков: developer.edubase.net
Электронная почта: info@edubase.net