Reads exams, classes, gradebooks and per-question item analysis from ICTExam, and can parse papers with AI and publish exams.
Setup
Choose your client, copy the config, then fill in any required environment variables.
claude mcp add ictexam --env ICTEXAM_BASE_URL='<ICTEXAM_BASE_URL>' --env ICTEXAM_EMAIL='<ICTEXAM_EMAIL>' --env ICTEXAM_PASSWORD='<ICTEXAM_PASSWORD>' -- npx -y ictexam-mcp~/.codex/config.toml
[mcp_servers.ictexam]
command = "npx"
args = ["-y", "ictexam-mcp"]
env = { ICTEXAM_BASE_URL = "<ICTEXAM_BASE_URL>", ICTEXAM_EMAIL = "<ICTEXAM_EMAIL>", ICTEXAM_PASSWORD = "<ICTEXAM_PASSWORD>" }
# codex mcp add ictexam --env ICTEXAM_BASE_URL='<ICTEXAM_BASE_URL>' --env ICTEXAM_EMAIL='<ICTEXAM_EMAIL>' --env ICTEXAM_PASSWORD='<ICTEXAM_PASSWORD>' -- npx -y ictexam-mcp~/.cursor/mcp.json
{
"mcpServers": {
"ictexam": {
"command": "npx",
"args": [
"-y",
"ictexam-mcp"
],
"env": {
"ICTEXAM_BASE_URL": "<ICTEXAM_BASE_URL>",
"ICTEXAM_EMAIL": "<ICTEXAM_EMAIL>",
"ICTEXAM_PASSWORD": "<ICTEXAM_PASSWORD>"
}
}
}
}.vscode/mcp.json
{
"servers": {
"ictexam": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"ictexam-mcp"
],
"env": {
"ICTEXAM_BASE_URL": "<ICTEXAM_BASE_URL>",
"ICTEXAM_EMAIL": "<ICTEXAM_EMAIL>",
"ICTEXAM_PASSWORD": "<ICTEXAM_PASSWORD>"
}
}
}
}~/.gemini/settings.json
{
"mcpServers": {
"ictexam": {
"command": "npx",
"args": [
"-y",
"ictexam-mcp"
],
"env": {
"ICTEXAM_BASE_URL": "<ICTEXAM_BASE_URL>",
"ICTEXAM_EMAIL": "<ICTEXAM_EMAIL>",
"ICTEXAM_PASSWORD": "<ICTEXAM_PASSWORD>"
}
}
}
}claude_desktop_config.json
{
"mcpServers": {
"ictexam": {
"command": "npx",
"args": [
"-y",
"ictexam-mcp"
],
"env": {
"ICTEXAM_BASE_URL": "<ICTEXAM_BASE_URL>",
"ICTEXAM_EMAIL": "<ICTEXAM_EMAIL>",
"ICTEXAM_PASSWORD": "<ICTEXAM_PASSWORD>"
}
}
}
}.trae/mcp.json
{
"mcpServers": {
"ictexam": {
"command": "npx",
"args": [
"-y",
"ictexam-mcp"
],
"env": {
"ICTEXAM_BASE_URL": "<ICTEXAM_BASE_URL>",
"ICTEXAM_EMAIL": "<ICTEXAM_EMAIL>",
"ICTEXAM_PASSWORD": "<ICTEXAM_PASSWORD>"
}
}
}
}Environment variables
ICTEXAM_BASE_URLICTEXAM_EMAILICTEXAM_PASSWORD
Replace the placeholders with your own credentials and keep them out of version control.