Mcp Quiz Generator

Name: Mcp Quiz Generator
Author: kkjzio

@kkjzio

About Mcp Quiz Generator

A quiz generator server based on Model Context Protocol (MCP) that generates Markdown questions according to requirements and converts them into HTML and Word format quiz files.

#quiz #generator

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "mcp-quiz-generator": {
      "command": "uvx",
      "args": [
        "mcp-quiz-generator",
        "--output-folder",
        "{output-folder-path}"
      ]
    }
  }
}

Tools

Generate quiz files from markdown content in specified format(s). This tool converts markdown quiz content to HTML and/or Word documents based on the format_type parameter. Markdown Text Format Requirements: The markdown content must follow this specific format for different question types: #### Single Choice Questions 1. What are the test automation frameworks developed by MaxSoft? - [x] IntelliAPI (correct answer marked with [x]) - [ ] WebBot (incorrect answers marked with [ ]) - [ ] Gauge - [ ] Selenium #### Multiple Choice Questions 2. What are the test automation frameworks developed by MaxSoft? - [x] IntelliAPI (multiple correct answers marked with [x]) - [x] WebBot (multiple correct answers marked with [x]) - [ ] Gauge (incorrect answers marked with [ ]) - [ ] Selenium #### True/False Questions 3. MaxSoft is a software company. - (x) True (correct answer marked with (x)) - ( ) False (incorrect answer marked with ( )) 4. The domain of MaxSoft is test automation framework development. - (x) True - ( ) False #### Short Answer Questions 5. Who is the Co-Founder of MaxSoft? - R:= Osanda (answer marked with R:= followed by the correct answer) Args: markdown_content: Markdown content following the specified format requirements above format_type: Output format - "html" for HTML only, "word" for Word only, "both" for both formats (default: "word") custom_filename: Optional custom filename (without extension). If not provided, timestamp will be used. Returns: Success message with file paths for the generated format(s)

Overview

What is Mcp Quiz Generator?

Mcp Quiz Generator is an MCP (Model Context Protocol) server that generates Markdown questions according to requirements and converts them into HTML and Word format quiz files. It is designed for users of MCP-compatible editors such as Cursor and VSCode.

How to use Mcp Quiz Generator?

Ensure Python 3.10+ and the uv package manager are installed. Configure the MCP server in Cursor/VSCode using either uvx (recommended) or a direct Python command, specifying the --output-folder parameter. Once configured, an AI assistant can call the tool with parameters markdown_content, format_type (html/word/both), and optional custom_filename to generate quiz files.

Key features of Mcp Quiz Generator

Supports single choice, multiple choice, true/false, and short answer questions
Generates interactive HTML quiz files for online answering
Produces Word quiz files (student version and teacher answer key)
Integrates with MCP protocol for use in editors like Cursor and VSCode
Uses uv for fast dependency management

Use cases of Mcp Quiz Generator

Quickly create a quiz on any topic, such as Prompt Engineering, via an AI assistant
Generate both HTML and Word files for a quiz in a single request
Produce separate student (without answers) and teacher (with answer key) Word documents
Customize output folder location for organizing generated quiz files

FAQ from Mcp Quiz Generator

What runtime and package manager are required?

Python 3.10 or higher and the uv package manager are needed.

How do I fix “uv command not found” when configuring the server?

Ensure uv is properly installed and added to your PATH, then restart your terminal or editor.

Why does the MCP server fail to connect?

Check that the paths in your MCP configuration file are correct, run uv sync to create the virtual environment, and inspect your editor’s MCP logs for detailed error information.

What if the generated file format is incorrect?

Verify that the Markdown content follows the specified format (e.g., correct indentation of options with 4 spaces) and that all question markups are valid.

Where are generated quiz files saved by default?

If no --output-folder is specified, files are saved in the data/ directory. You can override this with a custom directory path, and the program will create the directory if it doesn’t exist.