ictinnovations/ictexam-mcp

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기

17 stars 15 forks 품질 84 트렌드 41MIT

MCP server for ICTExam — read exams, gradebooks and item analysis; parse papers with AI and publish exams. By ICT Innovations.

개요

A Model Context Protocol server for , the AI exam authoring, delivery and auto-grading platform from ICT Innovations. It lets an AI assistant read your exams, gradebooks and per-question item analysis, and — only when you turn writes on — parse a question paper into a structured exam with AI and publish exams to students. Run it straight from npm with npx, or install it globally: Set these in your MCP client's server config (or a .env): Write tools appear only when ICTEXAM_MCP_ALLOW_WRITE=true: The server is . The three write tools are not registered at all unless you set ICTEXAM_MCP_ALLOW_WRITE=true, so a default install cannot change anything on the platform. Parsing a paper spends AI credit on the server, and publishing makes an exam live for students — both sit behind that switch on purpose.

README

원문 README의 일부입니다. 원문 보기.

ictexam-mcp

A Model Context Protocol server for ICTExam, the AI exam authoring, delivery and auto-grading platform from ICT Innovations.

It lets an AI assistant read your exams, gradebooks and per-question item analysis, and — only when you turn writes on — parse a question paper into a structured exam with AI and publish exams to students.

Install

Run it straight from npm with npx, or install it globally:

npx -y ictexam-mcp      # no install
npm install -g ictexam-mcp

Requires Node.js 18 or newer.

Configure

Set these in your MCP client’s server config (or a .env):

Variable	Required	Default
`ICTEXAM_BASE_URL`	yes		Your site, e.g. `https://app.ictlms.net` (no trailing `/api`)
`ICTEXAM_EMAIL`	yes		A teacher or admin account
`ICTEXAM_PASSWORD`	yes		Password for that account
`ICTEXAM_API_PREFIX`	no	`/api`	API mount path; set empty to hit the backend port directly
`ICTEXAM_MCP_ALLOW_WRITE`	no	`false`	Unlock the write tools (see Safety)
`ICTEXAM_TIMEOUT_MS`	no	`60000`	Per-request timeout (AI parsing can be slow)
`ICTEXAM_TLS_INSECURE`	no	`false`	Skip TLS verification — self-signed test servers only

Claude Desktop example

{
  "mcpServers": {
    "ictexam": {
      "command": "npx",
      "args": ["-y", "ictexam-mcp"],
      "env": {
        "ICTEXAM_BASE_URL": "https://app.ictlms.net",
        "ICTEXAM_EMAIL": "[email protected]",
        "ICTEXAM_PASSWORD": "your-password"
      }
    }
  }
}

Tools

Read tools are always available:

Tool	What it does
`ictexam_list_exams`	List exam papers (id, title, status, class, subject)
`ictexam_get_exam`	One paper’s settings, share links and questions
`ictexam_list_classes`	Classes (course groups)
`ictexam_list_subjects`	Subjects, each tied to a class
`ictexam_gradebook`	Per-exam totals and student marks
`ictexam_item_analysis`	Per-question difficulty, p-value and average mark

Write tools appear only when ICTEXAM_MCP_ALLOW_WRITE=true:

Tool	What it does
`ictexam_parse_question_paper`	Upload a local PDF/DOCX and AI-extract the questions
`ictexam_publish_exam`	Publish a paper; returns student and teacher share URLs
`ictexam_unpublish_exam`	Set a paper back to draft

Safety

The server is read-only by default. The three write tools are not registered at all unless you set ICTEXAM_MCP_ALLOW_WRITE=true, so a default install cannot change anything on the platform. Parsing a paper spends AI credit on the server, and publishing makes an exam live for students — both sit behind that switch on purpose. The client authenticates with the account’s own session cookie and

GitHub에서 전체 README 보기

설치

npx -y ictexam-mcp

MCP 초보자라면? mcpskill.org 가이드부터 시작하세요 →

설정

{
  "mcpServers": {
    "ictexam": {
      "command": "npx",
      "args": ["-y", "ictexam-mcp"],
      "env": {
        "ICTEXAM_BASE_URL": "https://app.ictlms.net",
        "ICTEXAM_EMAIL": "[email protected]",
        "ICTEXAM_PASSWORD": "your-password"
      }
    }
  }
}