EduBase MCP Server

공식

EduBase와 상호작용하여 고급 퀴즈, 시험 관리, 콘텐츠 구성 기능을 갖춘 종합적인 e-러닝 플랫폼을 활용하세요.

문서

EduBase MCP 서버

이 저장소는 EduBase 플랫폼을 위한 모델 컨텍스트 프로토콜(MCP) 서버의 구현체를 포함합니다. MCP 클라이언트(예: Claude Desktop)와 LLM이 EduBase 계정과 상호 작용하고 사용자를 대신하여 작업을 수행할 수 있도록 합니다. stdio, SSE 및 스트리밍 가능한 HTTP 전송 프로토콜을 지원합니다.

EduBase MCP demo GIF: Claude uploads math questions

EduBase란 무엇인가요?

EduBase는 교육 기관이나 기업에 적합하며, 학습을 더욱 즐겁고 간단하며 상호 작용적으로 만들어주는 혁신적인 모듈식 온라인 교육 플랫폼입니다.

EduBase를 선택해야 하는 이유는 무엇인가요?

EduBase는 다음과 같은 고유한 기능 조합으로 디지털 학습에 혁신을 일으킵니다.

고급 퀴즈 시스템: 매개변수화를 통해 동일한 질문의 무한한 변형 생성, 실시간 부정행위 감지, 아름다운 LaTeX 조판, 고급 STEM 지원 및 자동 채점
통합 학습 환경: 동영상, 시험, 문서, SCORM 모듈 등 모든 교육 콘텐츠를 하나의 직관적인 시스템에 중앙 집중화
엔터프라이즈급 보안: SSO 통합, 세분화된 접근 제어, 포괄적인 감사, GDPR 준수 등의 기능
기존 시스템과의 통합: LTI, 포괄적인 API 및 사용자 지정 통합 옵션을 통해 가능
AI 지원 도구: EduBase Assistant와 같은 도구를 통해 기존 콘텐츠를 대화형 퀴즈 및 평가로 즉시 변환하거나, 자료를 한 언어에서 다른 언어로 번역 가능

고등 교육 기관부터 기업 교육 부서까지, EduBase는 모든 기기에서 직관적인 사용자 경험을 유지하면서 특정 요구 사항에 맞게 확장됩니다.

데모 동영상

Claude를 사용하여 질문을 공동으로 생성 및 업로드하고, 시험을 예약하며, 사용자 결과를 분석합니다.

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

API 자격 증명 얻기

로그인 후 대시보드에서 통합 메뉴를 찾아 "통합 추가"를 클릭하고 "EduBase API" 유형을 선택하세요.

이 옵션이 보이지 않으면 MCPGITHUB 활성화 코드를 입력하거나 [email protected]으로 문의하여 액세스를 요청하세요.

도구

문서화된 각 API 엔드포인트는 edubase_<method>_<endpoint>이라는 이름의 개별 도구로 제공됩니다. 예를 들어 GET /user:me 엔드포인트의 도구 이름은 edubase_get_user_me입니다. 자세한 내용은 개발자 문서를 참조하세요.

구성

MCP 서버는 환경 변수를 사용하여 구성할 수 있습니다. 사용 가능한 변수는 다음과 같습니다.

변수	설명	필수 여부	기본값
`EDUBASE_API_URL`	EduBase API의 기본 URL, 대부분 `https://subdomain.edubase.net/api`입니다.	예	`https://www.edubase.net/api`
`EDUBASE_API_APP`	EduBase의 통합 앱 App ID, EduBase API의 `app`입니다. EduBase의 통합 세부 정보 창에서 찾을 수 있습니다.	인증이 포함된 HTTP 전송을 사용하는 경우 불필요, 그 외 예	-
`EDUBASE_API_KEY`	EduBase의 통합 앱 Secret 키, EduBase API의 `secret`입니다. EduBase의 통합 세부 정보 창에서 App ID와 함께 찾을 수 있습니다.	인증이 포함된 HTTP 전송을 사용하는 경우 불필요, 그 외 예	-
`EDUBASE_SSE_MODE`	SSE 전송을 사용하여 HTTP 모드로 MCP 서버를 시작합니다. 값은 `true`이어야 합니다.	아니요	`false`
`EDUBASE_STREAMABLE_HTTP_MODE`	스트리밍 가능한 HTTP 전송을 사용하여 HTTP 모드로 MCP 서버를 시작합니다. 값은 `true`이어야 합니다.	아니요	`false`
`EDUBASE_HTTP_PORT`	SSE 또는 스트리밍 가능한 HTTP 전송 모드를 사용하는 경우 HTTP 서버가 수신할 포트입니다.	아니요	3000
`EDUBASE_OAUTH`	OAuth 2.1 보호 리소스 동작을 활성화합니다. 인증되지 않은 요청은 `/.well-known/oauth-protected-resource`을(를) 가리키는 `401 + WWW-Authenticate`과(와) 함께 거부되며, Bearer 토큰은 EduBase API로 전달됩니다.	아니요	`false`
`EDUBASE_OAUTH_AUTHORIZATION_SERVER`	OAuth IdP 역할을 하는 EduBase 배포의 공개 기본 URL입니다. 보호 리소스 메타데이터 문서에서 인증 서버를 알리는 데 사용됩니다.	아니요	`EDUBASE_API_URL`에서 파생됨
`EDUBASE_OAUTH_RESOURCE_URL`	이 MCP 서버(OAuth 리소스 표시기)의 공개 기본 URL입니다. `WWW-Authenticate` 헤더 및 리소스 메타데이터에 사용됩니다.	아니요	`EDUBASE_API_URL`에서 파생됨

원격 MCP 서버로 사용

EduBase MCP 서버를 원격 MCP 서버로 MCP 클라이언트에 사용할 수 있습니다. 이를 위해서는 클라이언트가 액세스할 수 있는 곳에 MCP 서버를 호스팅한 다음, 서버에 연결하도록 클라이언트를 구성해야 합니다. SSE 또는 스트리밍 가능한 HTTP 전송 모드로 시작하고, 인터넷을 통해 원격으로 서버에 액세스할 때는 항상 HTTPS를 사용하세요!

원격 서버 인증

서버는 두 가지 모드로 사용할 수 있습니다.

클라이언트 인증 없음: 이 모드에서는 서버가 클라이언트의 인증을 요구하지 않습니다. 테스트 또는 개발 목적이나 폐쇄된 네트워크에서 유용하지만, 프로덕션 환경에서는 권장되지 않습니다. 이 경우 EDUBASE_API_APP 및 EDUBASE_API_KEY도 구성해야 합니다!
Bearer 토큰 인증 사용: 이 모드에서는 각 요청과 함께 Bearer 토큰을 전송해야 합니다. 프로덕션 환경에서 서버를 사용하는 권장 방법입니다. EduBase 계정에서 통합 앱을 생성하고 App ID와 Secret 키를 {app}:{secret} 형식으로 제공하여 base64로 인코딩된 토큰을 Bearer 토큰으로 얻을 수 있습니다. 그러면 서버는 이 토큰을 사용하여 클라이언트를 인증하고 API 엔드포인트에 대한 액세스를 승인합니다.
OAuth 2.1 사용 (EduBase를 IdP로): EDUBASE_OAUTH=true인 경우, 호환 클라이언트(Claude Desktop, Claude.ai 커넥터, Cursor, ChatGPT 커넥터 등)는 /.well-known/oauth-protected-resource을(를) 통해 EduBase 인증 서버를 검색하고, 동적으로 자체 등록(RFC 7591)하며, 사용자에게 EduBase 동의 화면을 안내하고, 인증 코드(PKCE S256 포함)를 불투명 액세스 토큰으로 교환합니다. MCP 서버는 해당 토큰을 그대로 EduBase API로 전달하며, EduBase API는 최초 동의 시 생성된 자동 프로비저닝된 MCP 통합으로 이를 확인합니다. App ID/Secret을 복사할 필요 없이 사용자는 클라이언트에서 "EduBase 연결"을 클릭하기만 하면 됩니다.

Claude Desktop과 함께 사용하기

단계별 안내는 EduBase와 Claude 연결: 완벽한 MCP 통합 가이드 블로그 게시물을 참조하세요.

제공된 EduBase MCP 서버 사용

제공된 EduBase MCP 서버(사용 가능한 경우)를 구성 없이 사용할 수 있습니다. OAuth 인증을 지원하는 경우 URL https://domain.edubase.net/mcp(실제 도메인으로 교체)을 사용하여 클라이언트에 원격 서버로 추가하거나, Authorization 헤더(Authorization: Bearer ${BASE64_ENCODED_TOKEN})에 적절한 Bearer 토큰을 사용하여 추가하면 됩니다.

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})의 Bearer 토큰으로 사용하는 것이 좋습니다.

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

Smithery를 통한 설치

Smithery를 통해 Claude Desktop용 EduBase MCP 서버를 자동으로 설치하려면:

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

연락처

웹사이트: www.edubase.net
개발자 문서: developer.edubase.net
이메일: [email protected]