Mcp Quiz Generator
@kkjzio
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.
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
uvfor 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.
