EduBase

공식

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

GitHub

이 MCP 사용해 보기스폰서

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

교육 콘텐츠 관리 — AI를 통해 questions, quizzes, exams 툴셋을 사용하여 질문, 퀴즈, 시험 및 해당 설정을 생성, 업데이트 또는 검색하도록 요청하세요.
결과 및 사용자 분석 — results, users, classes 툴셋을 사용하여 AI가 퀴즈/시험 결과, 인증서 다운로드, 사용자 세부 정보 및 클래스 멤버십을 가져오도록 하세요.
도구 액세스 제어 — EDUBASE_TOOLSETS를 통해 노출할 툴셋을 구성하고, EDUBASE_READONLY로 읽기 전용 모드를 활성화하거나, edubase_enable_toolsets 및 edubase_list_toolsets를 통해 모델이 필요에 따라 툴셋을 활성화하도록 할 수 있습니다.
파일 업로드 및 관리 — edubase_filebin 도구를 사용하여 임시 파일을 업로드할 수 있으며, SSRF 보호 및 EDUBASE_FILEBIN_ALLOWED_HOSTS를 통한 선택적 호스트 허용 목록을 지원합니다.
안전한 원격 액세스 — EduBase를 ID 공급자로 사용하는 OAuth 2.1로 연결하거나, 프로덕션 배포의 경우 Authorization 헤더와 함께 Bearer 토큰 인증을 사용하세요.

문서

EduBase MCP 서버

이 저장소는 EduBase 플랫폼용 Model Context Protocol(MCP) 서버의 구현을 포함합니다. MCP 클라이언트(예: Claude Desktop)와 LLM이 여러분의 EduBase 계정과 상호작용하고 여러분을 대신하여 작업을 수행할 수 있게 해줍니다. stdio, SSE 및 streamable 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 자격 증명 얻기

로그인한 후 대시보드에서 Integrations 메뉴를 찾아 "add integration"을 클릭하고 "EduBase API" 유형을 선택하세요.

이 옵션이 보이지 않는 경우, MCPGITHUB 활성화 코드를 입력하거나 info@edubase.net으로 문의하여 액세스를 요청하세요.

도구

문서화된 각 API 엔드포인트는 edubase_<method>_<endpoint>라는 이름의 도구로 제공됩니다. 예를 들어, GET /user:me 엔드포인트용 도구는 edubase_get_user_me라는 이름입니다. 태그, 권한 및 전송 엔드포인트는 모든 콘텐츠 유형에 대해 동일한 방식으로 작동하므로, type 인수를 가진 메서드당 하나의 도구를 공유합니다(예: POST /exam:tag, POST /quiz:tag 등의 경우 edubase_post_content_tag). 자세한 내용은 개발자 문서를 참조하세요.

도구 세트

도구는 도구 세트로 그룹화되어 필요한 도구만 노출할 수 있습니다. 도구가 적을수록 모델의 컨텍스트를 덜 사용하고 모델이 올바른 도구를 선택하기 쉬워집니다. 모든 도구 세트는 기본적으로 활성화되어 있습니다.

도구 세트	도구 용도
`files`	임시 파일 업로드(항상 활성화)
`questions`	질문
`quizzes`	퀴즈 세트, 해당 질문, 설정 및 채점 프리셋
`exams`	시험, 해당 설정, 사용자, 인증서 및 브랜딩
`results`	퀴즈 및 시험 결과, 인증서 다운로드
`users`	사용자, 이름, 그룹 및 로그인 링크
`classes`	클래스 및 클래스 멤버십
`organizations`	조직, 구성원, 부서, 역량 및 웹훅
`integrations`	통합 및 해당 키
`tags`	콘텐츠의 태그 및 태그 첨부
`permissions`	콘텐츠에 대한 사용자 권한 및 소유권 전송
`metrics`	맞춤 지표

EDUBASE_TOOLSETS에서 쉼표로 구분된 목록으로 도구 세트를 선택하세요(예: questions,quizzes,exams). EDUBASE_READONLY=true을 설정하여 데이터를 읽는 도구만 노출하세요(get 도구 및 edubase_post_question_export와 같이 다운로드 링크만 생성하는 도구).

EDUBASE_DYNAMIC_TOOLSETS=true을 설정하여 도구 세트를 주문형으로 활성화하세요: 세션은 필수 도구만으로 시작하고, 모델은 edubase_enable_toolsets 도구로 필요한 도구 세트를 활성화합니다(edubase_list_toolsets로 나열됨). 이렇게 하면 모든 도구를 미리 로드하는 클라이언트의 초기 도구 목록이 작게 유지되지만, 변경 사항이 알림될 때 도구 목록을 새로 고치는 클라이언트가 필요합니다.

HTTP 전송을 사용하는 경우, 클라이언트는 EduBase-Mcp-Toolsets, EduBase-Mcp-ReadOnly 및 EduBase-Mcp-Dynamic 헤더 또는 toolsets, read_only 및 dynamic_toolsets 쿼리 매개변수(예: https://domain.edubase.net/mcp?toolsets=exams&read_only=true)로 자체 세션의 구성을 더 좁힐 수 있습니다. 세션은 서버 구성에서 비활성화된 도구 세트나 쓰기 도구를 활성화할 수 없습니다.

구성

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`	streamable HTTP 전송으로 HTTP 모드에서 MCP 서버를 시작합니다. 값은 `true`여야 합니다.	아니요	`false`
`EDUBASE_TOOLSETS`	활성화된 도구 세트의 쉼표로 구분된 목록 또는 `all`.	아니요	`all`
`EDUBASE_READONLY`	데이터를 읽는 도구만 노출합니다. 값은 `true`여야 합니다.	아니요	`false`
`EDUBASE_OUTPUT_SCHEMAS`	도구의 출력 스키마 및 구조화된 도구 결과: `off`은 출력 스키마 없이 도구를 나열하고 결과를 JSON 텍스트로만 반환하며, `on`은 전체 출력 스키마를 포함하고, `fields`은 필드 설명 없이 출력 스키마를 포함합니다(구조화된 결과는 유지하지만 스키마의 대부분 토큰을 절약).	아니요	`fields`
`EDUBASE_CONFIG_PROVIDERS`	HTTP 전송 사용 시 요청에서 세션 구성을 제공할 수 있는 호스팅 제공자의 쉼표로 구분된 목록입니다. 현재 `smithery`만 지원됩니다(base64로 인코딩된 `config` 쿼리 매개변수).	아니요	-
`EDUBASE_DYNAMIC_TOOLSETS`	파일 업로드 도구만으로 세션을 시작하고 모델이 도구 세트를 주문형으로 활성화하도록 합니다. 값은 `true`여야 합니다.	아니요	`false`
`EDUBASE_HTTP_PORT`	SSE 또는 streamable 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 서버의 공개 기본 URL(OAuth 리소스 표시자)입니다. `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 서버로 사용

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

원격 서버 인증

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

클라이언트 인증 없음: 이 모드에서 서버는 클라이언트의 인증을 요구하지 않습니다. 테스트나 개발 목적, 또는 폐쇄된 네트워크에서 유용하지만 프로덕션 사용에는 권장되지 않습니다. 이를 위해 EDUBASE_API_APP 및 EDUBASE_API_KEY도 함께 서버를 구성해야 합니다!
Bearer 토큰 인증: 이 모드에서 서버는 각 요청에 Bearer 토큰이 전송되도록 요구합니다. 프로덕션에서 서버를 사용하는 권장 방법입니다. EduBase 계정에서 통합 앱을 만들고 {app}:{secret} 형식으로 App ID와 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로 전달하며, API는 첫 동의 시 생성된 자동 프로비저닝 MCP 통합으로 해석합니다. 복사할 App ID/Secret이 없습니다 — 사용자는 클라이언트에서 "Connect EduBase"를 클릭하기만 하면 됩니다.

Claude Desktop과 함께 사용

단계별 안내는 EduBase를 Claude와 연결하는 방법에 대한 블로그 게시물 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를 통한 설치

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

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

개발

npm test를 실행하여 서버를 빌드하고 도구 목록을 확인하세요: 도구 목록 및 서버 지침의 크기 예산, 도구 설명, 도구 세트, 읽기 전용 및 동적 도구 세트 모드, HTTP 전송의 구성 처리를 확인합니다. 새 도구가 예산을 초과하면 스키마를 줄이거나 test/server.test.mjs에서 예산을 의도적으로 늘리세요. 모든 클라이언트가 모든 세션에서 도구 목록을 지불하기 때문입니다.

연락처

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