EduBase

EduBase MCP サーバー

このリポジトリには、EduBase プラットフォーム向けの Model Context Protocol（MCP）サーバーの実装が含まれています。これにより、MCP クライアント（たとえば Claude Desktop）や LLM がお客様の EduBase アカウントと連携し、お客様に代わってタスクを実行できるようになります。stdio、SSE、streamable HTTP の各トランスポートプロトコルをサポートしています。

EduBase とは？

EduBase は、学習をより楽しく、よりシンプルで、よりインタラクティブにする、革新的でモジュール式のオンライン教育プラットフォームであり、教育機関や企業に適しています。

EduBase を選ぶ理由

EduBase は、独自の機能の組み合わせによってデジタル学習を革新します。

• 高度なクイズシステム — パラメーター化により同じ問題の無限のバリエーションを実現し、リアルタイムのカンニング検出、美しい LaTeX 組版、高度な STEM サポート、自動採点を備えています
• 統合学習環境 — 動画、試験、ドキュメント、SCORM モジュールなど、すべての教育コンテンツを 1 つの直感的なシステムに集約します
• エンタープライズグレードのセキュリティ — SSO 連携、きめ細かなアクセス制御、包括的な監査、GDPR 準拠などの機能を備えています
• 統合 — LTI、包括的な API、カスタム統合オプションを通じて、既存のシステムと連携します
• AI 支援ツール — EduBase Assistant など。既存のコンテンツを瞬時にインタラクティブなクイズや評価に変換したり、教材をある言語から別の言語へ翻訳したりできます

高等教育機関から企業の研修部門まで、EduBase はお客様の特定のニーズに合わせて拡張しつつ、すべてのデバイスで直感的なユーザーエクスペリエンスを維持します。

デモ動画

Claude を使って、問題を共同で作成・アップロードし、試験をスケジュールし、ユーザーの結果を分析する：

API 認証情報の取得

ログイン後、ダッシュボードで Integrations メニューを探し、「add integration」をクリックして「EduBase API」タイプを選択してください。

このオプションが表示されない場合は、MCPGITHUB アクティベーションコードを入力するか、[email protected] までお気軽にご連絡いただき、アクセスをご依頼ください。

ツール

ドキュメント化された各 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	組織、メンバー、部門、職務、コンピテンシー、Webhook
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 クライアント（例：+ メニューまたは / メニュー）から開始できる、すぐに使えるワークフローです。補完に対応するクライアントでは、入力中に引数の値として、質問の種類や独自の試験、Quiz セット、クラスが提案されます。

プロンプト	機能	引数
質問を作成する（edubase_prompt_create_question）	新しい質問を作成し、QuestionBase に公開します	type、subject、任意の difficulty および language
ドキュメントから質問を作成する（edubase_prompt_questions_from_document）	添付されたドキュメント（またはファイルパスや URL）から質問を作成します。計画を承認した後、必要に応じて Quiz セットに追加します	document、任意の questions（件数）、types、quiz および language
試験を作成する（edubase_prompt_create_exam）	トピックに関する質問を生成し、新しい Quiz セットにまとめて、そこから試験を作成します	topic、questions（件数）、任意の types（カンマ区切り）、language および schedule
ジャーニー付きの試験を作成する（edubase_prompt_create_exam_journey）	上記と同様に試験を作成した後、関連するアカウントの試験を再利用しながら、短い試験ジャーニーを作成して公開します。必要に応じて、練習用の Quiz セットと後続の試験も作成します	試験を作成する と同じ
試験をコピーする（edubase_prompt_copy_exam）	同じ Quiz セットと設定を使用して、新しい期間の試験を作成します	exam、schedule、任意の title
クラスを試験に割り当てる（edubase_prompt_assign_class_to_exam）	クラスのアクティブなメンバーを試験に割り当てます	exam、class
試験結果を要約する（edubase_prompt_summarize_exam_results）	試験結果を分析し、必要に応じて要約を試験に保存します	exam、任意の focus および save（ask、yes または no）
試験ジャーニーを確認する（edubase_prompt_exam_journey_status）	試験ジャーニーのユーザーの進捗状況と、進行が止まっているユーザーを表示します	exam

プロンプトは、対応するツールセットが有効な場合にのみ表示されます。読み取り専用モードでは、最後の 2 つだけが表示されます。

試験の質問の種類が空欄の場合、引き出し機能に対応するクライアントでは、チェックボックスを使って質問されます。また、元に戻せない変更（試験、Quiz セット、質問、ユーザー、組織、インテグレーションの削除、所有権の移転、新しい試験ラウンドの開始、インテグレーションキーのローテーション）を行う前に、これらのクライアントでは変更の確認を求められます。これらの質問を無効にするには、EDUBASE_ELICITATION=false を設定します。

リソース

参照ドキュメントはリソースとして利用できるほか、リソースを読み取れないモデル向けに edubase_mcp_reference ツールからも利用できます。edubase://reference/questions（質問のフィールドと種類）と edubase://reference/exam-journeys（ポータブルな試験ジャーニー形式）が用意されています。これらは、スキルを利用できないクライアント向けに、EduBase のスキルで説明されている内容を網羅しています。試験と Quiz セットもリソースとして添付でき（edubase://exam/{exam} および edubase://quiz/{quiz}）、その内容が一覧表示され、提案されます。EDUBASE_CONTENT_RESOURCES=false を設定するか、セッションで EduBase-Mcp-Content-Resources: false ヘッダー、content_resources=false クエリパラメーター、または Smithery 設定の edubaseContentResources を指定すると、これらを無効にできます。

試験、Quiz セット、ジャーニーを作成または変更するツールには、EduBase 内のそれぞれのページへのリンクが含まれます。

設定

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_TOOLSETS	有効にするツールセットのカンマ区切りリスト、または all。	いいえ	all
EDUBASE_READONLY	データを読み取るツールのみを公開します。値は true である必要があります。	いいえ	false
EDUBASE_OUTPUT_SCHEMAS	ツールの出力スキーマと構造化されたツールの結果を設定します。off は出力スキーマなしでツールを一覧表示し、結果を JSON テキストのみで返します。on は完全な出力スキーマを含めます。fields はフィールドの説明を除いた出力スキーマを含めます（構造化された結果は維持しつつ、スキーマのトークンを大幅に節約します）。	いいえ	fields
EDUBASE_CONFIG_PROVIDERS	HTTP トランスポート使用時に、リクエストでセッション設定を提供できるホスティングプロバイダーのカンマ区切りリストです。現在サポートされているのは smithery（Base64 エンコードされた config クエリパラメーター）のみです。	いいえ	-
EDUBASE_CONTENT_RESOURCES	アカウントの試験とクイズセットをリソースとして一覧表示します。認証情報なしでサーバーを検査する場合など、無効にするには false を設定します。リファレンスドキュメントは引き続き利用できます。	いいえ	true
EDUBASE_DYNAMIC_TOOLSETS	ファイルアップロードツールのみでセッションを開始し、モデルが必要に応じてツールセットを有効にできるようにします。値は true である必要があります。	いいえ	false
EDUBASE_ELICITATION	クライアントがエリシテーションに対応している場合、元に戻せない変更の確認と、プロンプトの質問形式の選択をクライアント経由でユーザーに求めます。無効にするには false を設定します。	いいえ	true
EDUBASE_HTTP_PORT	SSE またはストリーミング可能な HTTP トランスポートモードの使用時に、HTTP サーバーがリッスンするポートです。	いいえ	3000
EDUBASE_OAUTH	OAuth 2.1 の保護リソース動作を有効にします。認証されていないリクエストは、/.well-known/oauth-protected-resource/mcp を指す 401 + WWW-Authenticate で拒否され、ベアラートークンは 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 またはストリーミング可能な HTTP トランスポートモードで起動し、インターネット経由でリモートサーバーにアクセスする際は、必ず HTTPS を使用してください。

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

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

• クライアント認証なし：このモードでは、サーバーはクライアントに認証を要求しません。テストや開発、または閉じたネットワーク内での使用には便利ですが、本番環境での使用は推奨されません。このモードでは、EDUBASE_API_APP と EDUBASE_API_KEY も使ってサーバーを設定する必要があります。
• Bearer トークン認証あり：このモードでは、各リクエストで Bearer トークンを送信する必要があります。本番環境でのサーバーの使用には、この方法を推奨します。EduBase アカウントで統合アプリを作成し、App ID と Secret key を {app}:{secret} の形式で指定して Base64 エンコードすることで、Bearer トークンを取得できます。サーバーはこのトークンを使ってクライアントを認証し、API エンドポイントへのアクセスを許可します。
• OAuth 2.1（IdP としての EduBase）：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 に接続する方法：MCP 統合の完全ガイドに関するブログ記事をご覧ください。

提供されている EduBase MCP サーバーを使用する

提供されている EduBase MCP サーバー（利用可能な場合）は、クライアントが OAuth 認証に対応していれば、URL https://domain.edubase.net/mcp（実際のドメインに置き換えてください）を使ってリモートサーバーとして追加するだけで、設定なしで使用できます。OAuth 認証に対応していない場合は、適切な Bearer トークンを 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 ヘッダーの Bearer トークンとして使用することをおすすめします（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

開発

npm test を実行すると、サーバーをビルドし、ツール一覧を確認できます。確認対象は、ツール一覧とサーバーの指示のサイズ予算、ツールの説明、ツールセット、読み取り専用および動的ツールセットのモード、HTTP トランスポートの設定処理です。新しいツールによって予算を超える場合は、スキーマを短くするか、すべてのクライアントが各セッションでツール一覧の分を負担することを踏まえたうえで、test/server.test.mjs の予算を意図的に引き上げてください。

src/references 内のリファレンスドキュメントは EduBase の開発者向けドキュメントから生成されています。質問フィールドまたは試験の進行形式が変更された場合は、node scripts/sync-references.mjs <path to the developer documentation repository> で再生成してください。

ドキュメントの同期ポイント： ツール、プロンプト、リファレンスの最終同期日は 2026-10-26 です。開発者向けドキュメントのコミット fe995a62a2（Organization permission improvements）に対して同期し、EduBase の develop ブランチのコミット 9fd4968d26（Organization member restrictions、リリース 8.6.0 以降）に対して確認済みです。 サーバーを最新の状態にするには、開発者向けドキュメントのリポジトリで git log --oneline fe995a62a2..HEAD と git diff fe995a62a2..HEAD -- docs/api/endpoints を実行し、EduBase のリポジトリで git log --oneline 9fd4968d26..HEAD -- system/do/api.do.php を実行してください。src/tools の該当するツール（および関連するプロンプトとツールセットのガイド）を更新し、リファレンスドキュメントを再生成して、このマーカーを新しい HEAD コミットに更新してください。両者に相違がある場合は、EduBase のリポジトリを優先します。

お問い合わせ

ウェブサイト：www.edubase.net
開発者向けドキュメント：developer.edubase.net
メール：[email protected]