EduBase MCP Server

公式

EduBaseと連携し、高度なクイズ作成、試験管理、コンテンツ整理機能を備えた総合的なeラーニングプラットフォームとやり取りできます。

ドキュメント

EduBase MCPサーバー

このリポジトリには、EduBaseプラットフォーム向けのModel Context Protocol（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` です。App IDと共にEduBaseの統合詳細ウィンドウで確認できます。	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保護リソース動作を有効にします。未認証のリクエストは `401 + WWW-Authenticate` で拒否され、`/.well-known/oauth-protected-resource` を指し、ベアラートークンは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サーバーとしての使用

MCPクライアント用のリモートMCPサーバーとしてEduBase MCPサーバーを使用できます。これを行うには、クライアントがアクセスできる場所でMCPサーバーをホストし、クライアントがサーバーに接続するように設定する必要があります。SSEまたはストリーミングHTTPトランスポートモードで起動し、インターネット経由でリモートアクセスする場合は常にHTTPSを使用してください。

リモートサーバーでの認証

サーバーは2つのモードで使用できます。

クライアント認証なし：このモードでは、サーバーはクライアントからの認証を要求しません。テストや開発目的、または閉じたネットワーク内で役立ちますが、本番環境での使用は推奨されません。この場合、EDUBASE_API_APP と EDUBASE_API_KEY も設定する必要があります。
ベアラートークン認証あり：このモードでは、サーバーは各リクエストでベアラートークンの送信を要求します。本番環境でサーバーを使用する推奨方法です。EduBaseアカウントで統合アプリを作成し、App IDとSecretキーを {app}:{secret} 形式でBase64エンコードしてトークンとして提供することで、ベアラートークンを取得できます。サーバーはこのトークンを使用してクライアントを認証し、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に転送し、最初の同意時に作成された自動プロビジョニングされた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}）に適切なベアラートークンを指定して使用します。

**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
メール: [email protected]