quiz-mcp 0.0.1

package/README.md

@@ -0,0 +1,85 @@
+# Quiz MCP
+
+A Model Context Protocol (MCP) server for running interactive quizzes. This tool bridges the gap between AI generation and user interaction by allowing agents to generate quizzes and immediately present them to users in a polished web interface.
+
+## Features
+
+-   **Interactive Web UI**: Built with SvelteKit for a responsive and smooth experience.
+-   **MCP Support**: Fully compatible with Model Context Protocol for AI agent integration.
+-   **Multiple Question Types**:
+    -   Single Choice
+    -   Multiple Choice
+    -   Open Text
+-   **Flexible Configuration**: customizable themes, timers, and shuffling.
+-   **CLI Tool**: easy-to-use command line interface for local testing and usage.
+
+## Local-first & Privacy by Design
+
+Quiz MCP runs entirely on your machine.
+
+-   **No external APIs**
+-   **No cloud services**
+-   **No telemetry**
+-   **No user data leaves your system**
+
+AI agents communicate with the quiz UI through a local MCP server. All interactions stay within your local environment (unless you explicitly configure a webhook).
+
+## Installation
+
+```bash
+pnpm install
+pnpm build
+```
+
+## Usage
+
+### Standalone Mode (CLI)
+
+Run a quiz directly from a local JSON file:
+
+```bash
+# Run a JavaScript quiz
+pnpm quiz:js
+
+# Run a Web Development quiz
+pnpm quiz:web
+```
+
+Or run any custom file:
+
+```bash
+pnpm quiz --file ./my-quiz.json --open
+```
+
+### MCP Mode (AI Agent)
+
+Start the MCP server to allow AI agents to connect:
+
+```bash
+pnpm quiz:mcp
+```
+
+The server runs on port 3000 (default) or the port specified in your configuration.
+
+## Development
+
+1.  Start the development server:
+    ```bash
+    pnpm dev
+    ```
+
+2.  Run the CLI in dev mode:
+    ```bash
+    pnpm quiz:js
+    ```
+
+## Architecture
+
+The project consists of three main parts:
+1.  **`src/lib`**: Shared logic and types.
+2.  **`src/routes`**: SvelteKit web application.
+3.  **`src/cli`**: Node.js CLI entry points for both the standalone runner and the MCP server.
+
+## License
+
+MIT

package/bin/quiz

@@ -0,0 +1,16 @@
+#!/usr/bin/env node
+/**
+ * Quiz MCP - Unified CLI
+ */
+
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const cliPath = join(__dirname, '..', 'dist', 'cli.js');
+
+const { main } = await import(cliPath);
+main(process.argv).catch((err) => {
+	console.error('Unhandled error:', err);
+	process.exit(1);
+});

package/bin/quiz-runner

@@ -0,0 +1,18 @@
+#!/usr/bin/env node
+/**
+ * Quiz MCP - Runner CLI (Legacy Alias)
+ */
+
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const cliPath = join(__dirname, '..', 'dist', 'cli.js');
+
+const { main } = await import(cliPath);
+
+const newArgv = [process.argv[0], 'run', ...process.argv.slice(1)];
+main(newArgv).catch((err) => {
+	console.error('Unhandled error:', err);
+	process.exit(1);
+});

package/bin/quiz-runner-mcp

@@ -0,0 +1,18 @@
+#!/usr/bin/env node
+/**
+ * Quiz MCP - MCP Server CLI (Legacy Alias)
+ */
+
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const cliPath = join(__dirname, '..', 'dist', 'cli.js');
+
+const { main } = await import(cliPath);
+
+const newArgv = [process.argv[0], 'mcp', ...process.argv.slice(1)];
+main(newArgv).catch((err) => {
+	console.error('Unhandled error:', err);
+	process.exit(1);
+});