Skip to main content
Glama

Quiz MCP Server

An interactive programming quiz server built with the Model Context Protocol (MCP) and MCP Apps SDK. Features 10 quiz questions across multiple categories (Web Fundamentals, JavaScript, Git, Networking, Algorithms, TypeScript, CSS, Databases, Security, Systems) with three difficulty levels.

Features

  • start-quiz — Launches an interactive quiz UI with 10 questions

  • submit-answer — Server-side grading with explanations

  • get-hint — Provides hints for each question

Requirements

  • Node.js >= 20.0.0

  • npm >= 9

Quick Start

# Install dependencies
npm install

# Build the UI (bundles mcp-app.html into dist/)
npm run build

# Start the server
npm run serve

The server starts at http://localhost:3001/mcp.

Development

npm run dev

This runs both the Vite UI watcher and the server with auto-reload concurrently.

Scripts

Script

Description

npm run build

Build the bundled UI (dist/mcp-app.html)

npm run serve

Start the MCP server (tsx)

npm run dev

Watch mode — rebuilds UI & restarts server on changes

npm start

Production start (node --import tsx main.ts)

Testing

# Initialize
curl -X POST http://localhost:3001/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","method":"initialize","id":1,"params":{"protocolVersion":"2025-03-26","capabilities":{},"clientInfo":{"name":"test","version":"1.0.0"}}}'

# List tools
curl -X POST http://localhost:3001/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","method":"tools/list","id":2}'

Project Structure

├── main.ts              # Entry point — HTTP & stdio transport setup
├── server.ts            # MCP server — tools, resources, quiz logic
├── mcp-app.html         # UI entry point (built by Vite into dist/)
├── src/
│   ├── mcp-app.tsx      # React quiz UI component
│   ├── mcp-app.module.css
│   └── global.css
├── vite.config.ts       # Vite config (single-file bundle)
├── tsconfig.json        # TypeScript config (UI + server)
└── package.json

Environment Variables

Variable

Default

Description

PORT

3001

HTTP server port

License

MIT

-
security - not tested
F
license - not found
-
quality - not tested

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/lolzone13/Quiz-MCP-Server'

If you have feedback or need assistance with the MCP directory API, please join our Discord server