EduBase

공식

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

GitHub

EduBase MCP(으)로 무엇을 할 수 있나요?

퀴즈 및 질문 관리 — LaTeX 지원 및 매개변수화를 통해 퀴즈 질문을 생성, 업데이트 및 구성합니다. edubase_post_quiz_questions와 같은 도구를 사용합니다.
시험 일정 및 관리 — 시험을 설정하고, 사용자나 그룹에 할당하며, 시간 제한 및 채점 규칙과 같은 설정을 구성합니다.
사용자 및 그룹 정보 조회 — edubase_get_user_me 및 관련 엔드포인트를 통해 프로필 세부 정보, 등록 데이터, 그룹 멤버십을 조회합니다.
시험 결과 분석 — 제출 데이터, 점수 및 통계를 가져와 학습자 성과를 검토하고 이상 징후를 감지합니다.
EduBase에 파일 업로드 — edubase_filebin을 사용하여 문서, 비디오 또는 SCORM 패키지를 플랫폼으로 전송합니다.

문서

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 활성화 코드를 입력하거나 info@edubase.net으로 문의하여 액세스를 요청하세요.

도구

문서화된 각 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의 통합 앱 비밀 키, 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`과 함께 거부되며, 베어러 토큰은 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`에서 파생됨
`EDUBASE_ALLOW_PRIVATE_NETWORK`	HTTP 전송 사용 시, `edubase_filebin` 도구는 비공개, 루프백, 링크-로컬 및 예약된 주소로의 아웃바운드 요청을 차단하고(SSRF 보호) 로컬 파일 경로를 거부합니다. 신뢰할 수 있는 비공개 네트워크의 자체 호스팅 배포 등에서 허용하려면 `true`로 설정하세요. 로컬 사용자만 호출하는 stdio 모드에서는 효과가 없습니다.	아니요	`false`
`EDUBASE_FILEBIN_ALLOWED_HOSTS`	`edubase_filebin` 업로드 대상으로 허용되는 호스트 이름의 선택적 쉼표 구분 허용 목록입니다(정확한 호스트 또는 모든 하위 도메인, 예: `edubase.net`). 비어 있으면 모든 공개 호스트가 허용됩니다(위의 주소 필터링이 여전히 적용됨).	아니요	-

원격 MCP 서버로 사용

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

원격 서버 인증

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

클라이언트 인증 없이: 이 모드에서는 서버가 클라이언트의 인증을 요구하지 않습니다. 테스트 또는 개발 목적이나 폐쇄된 네트워크에서 유용하지만 프로덕션 환경에는 권장되지 않습니다. 이 경우 EDUBASE_API_APP 및 EDUBASE_API_KEY도 서버에 구성해야 합니다!
베어러 토큰 인증 사용: 이 모드에서는 서버가 각 요청과 함께 베어러 토큰을 보내도록 요구합니다. 프로덕션 환경에서 서버를 사용하는 권장 방법입니다. 통합 앱을 만들고 App ID와 비밀 키를 {app}:{secret} 형식으로 base64 인코딩하여 토큰으로 제공하면 EduBase 계정에서 베어러 토큰을 얻을 수 있습니다. 그러면 서버는 이 토큰을 사용하여 클라이언트를 인증하고 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/비밀 키가 없습니다. 사용자는 클라이언트에서 "EduBase 연결"을 클릭하기만 하면 됩니다.

Claude Desktop과 함께 사용하기

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

제공된 EduBase MCP 서버 사용

제공된 EduBase MCP 서버(사용 가능한 경우)를 구성 없이 사용할 수 있습니다. OAuth 인증을 지원하는 경우 URL https://domain.edubase.net/mcp(실제 도메인으로 교체)을 사용하거나 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를 통한 설치

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

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

연락처

웹사이트: www.edubase.net
개발자 문서: developer.edubase.net
이메일: info@edubase.net