ictexam-mcp について
ictexam-mcpは、教師や管理者向けにICTExamとAIアシスタントを接続するMCPサーバーです。試験、成績表、設問分析を読み取れます。書き込みを有効にすると、試験問題の解析と公開も行えます。
主な機能
- 01試験、クラス、科目の一覧表示
- 02試験設定と設問の取得
- 03成績表と学生の得点取得
- 04設問ごとの難易度と平均点の確認
- 05任意で試験問題を解析・公開
活用シーン
- 01試験の状態と設問設定を確認
- 02クラスの試験結果を確認
- 03設問の難易度と得点を分析
- 04PDFまたはDOCXの問題用紙を解析して公開
MCP 対応
アカウントのセッションを使ってICTExam REST APIに接続し、試験や成績を読み取るツールをMCPクライアントに提供します。書き込みツールは初期状態では登録されず、ICTEXAM_MCP_ALLOW_WRITE=trueで有効になります。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
npx -y ictexam-mcpICTEXAM_BASE_URLBase URL of your ICTExam site, e.g. https://app.ictlms.net (no trailing /api).ICTEXAM_EMAILA teacher or admin account email.ICTEXAM_PASSWORDシークレットPassword for the account.ICTEXAM_API_PREFIXPath the API is mounted under. Defaults to /api (behind the usual reverse proxy). Set empty to talk to the backend port directly.ICTEXAM_MCP_ALLOW_WRITEUnlocks the write tools: parse a paper with AI (spends server AI credit), publish and unpublish exams. When false these tools are not registered at all. Leave off unless you mean it.ICTEXAM_TIMEOUT_MSPer request timeout in milliseconds. Defaults to 60000 (AI parsing can be slow).ICTEXAM_TLS_INSECURESkip TLS certificate verification. Only for a self-signed test server.ローカルサーバーにはマシン上の実行環境（Node.js 18 以上など）が必要です。設定ファイルの場所はクライアントごとに異なります。
ツール
6掲載時のツール一覧 · 2 日前に更新
| パラメーター | 型 | 必須 | 説明 |
|---|---|---|---|
| class_id | integer | いいえ | 任意の class id フィルター。 |
| subject_id | integer | いいえ | 任意の科目 ID フィルター。 |
詳細
ictexam-mcp
ICT Innovations が提供する、AI を活用した試験の作成、実施、自動採点プラットフォーム ICTExam 用の Model Context Protocol サーバーです。
AI アシスタントが試験、成績簿、設問ごとの項目分析を読み取れるようになります。また、書き込みを有効にした場合に限り、AI で問題用紙を構造化された試験に変換し、学生に公開できます。
インストール
npx を使って npm から直接実行するか、グローバルにインストールします。
npx -y ictexam-mcp # no install
npm install -g ictexam-mcp
Node.js 18 以降が必要です。
設定
MCP クライアントのサーバー設定（または .env）に以下を設定します。
| 変数 | 必須 | デフォルト | |
|---|---|---|---|
ICTEXAM_BASE_URL | はい | サイトの URL。例：https://app.ictlms.net（末尾に/apiを付けないでください） | |
ICTEXAM_EMAIL | はい | 教師または管理者のアカウント | |
ICTEXAM_PASSWORD | はい | 上記アカウントのパスワード | |
ICTEXAM_API_PREFIX | いいえ | /api | API のマウントパス。バックエンドのポートに直接アクセスするには空に設定します |
ICTEXAM_MCP_ALLOW_WRITE | いいえ | false | 書き込みツールを有効にします（「安全性」を参照） |
ICTEXAM_TIMEOUT_MS | いいえ | 60000 | リクエストごとのタイムアウト（AI による解析には時間がかかる場合があります） |
ICTEXAM_TLS_INSECURE | いいえ | false | TLS 検証をスキップします。自己署名のテストサーバーでのみ使用してください |
Claude Desktop の例
{
"mcpServers": {
"ictexam": {
"command": "npx",
"args": ["-y", "ictexam-mcp"],
"env": {
"ICTEXAM_BASE_URL": "https://app.ictlms.net",
"ICTEXAM_EMAIL": "[email protected]",
"ICTEXAM_PASSWORD": "your-password"
}
}
}
}
ツール
読み取りツールは常に利用できます。
| ツール | 機能 |
|---|---|
ictexam_list_exams | 試験用紙の一覧（ID、タイトル、ステータス、クラス、科目） |
ictexam_get_exam | 1 つの試験用紙の設定、共有リンク、設問 |
ictexam_list_classes | クラス（コースグループ） |
ictexam_list_subjects | 科目と、それぞれに紐づくクラス |
ictexam_gradebook | 試験ごとの合計点と学生の得点 |
ictexam_item_analysis | 設問ごとの難易度、p 値、平均点 |
書き込みツールは ICTEXAM_MCP_ALLOW_WRITE=true の場合にのみ表示されます。
| ツール | 機能 |
|---|---|
ictexam_parse_question_paper | ローカルの PDF/DOCX をアップロードし、AI で設問を抽出します |
ictexam_publish_exam | 試験用紙を公開します。学生用と教師用の共有 URL を返します |
ictexam_unpublish_exam | 試験用紙を下書きに戻します |
安全性
このサーバーはデフォルトで読み取り専用です。ICTEXAM_MCP_ALLOW_WRITE=true を設定しない限り、3 つの書き込みツールは登録されないため、デフォルトのインストールではプラットフォーム上の情報を変更できません。問題用紙の解析ではサーバー上の AI クレジットを消費し、公開すると試験が学生に公開されます。そのため、どちらも意図的にこのスイッチの背後に置かれています。クライアントはアカウント固有のセッション Cookie で認証し、Web アプリと同じ方法で書き込み時に CSRF トークンを付加します。パスワードを、指定された環境変数の範囲を超えて保存またはログに記録することはありません。
接続方法
ICTExam は FastAPI バックエンドで動作します。このサーバーはメールアドレスとパスワードで一度サインインし、プロセスの実行中はセッション Cookie を保持して、/api 以下の REST API（設定可能）と通信します。API キーの用意は不要です。
概要
ICTExam、ICTContact、ICTDialer、ICTFax、ICTPBX を手がけるチーム、ICT Innovations の Tahir Almas が開発しました。ICTExam にはネイティブの Moodle アクティビティモジュールが付属しています（LTI 1.3、成績の返却、名簿の同期）。詳しくは ictlms.net をご覧ください。
MIT ライセンスです。問題の報告やプルリクエストは github.com/ictinnovations/ictexam-mcp で受け付けています。
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。