
Quiz Master është një aplikacion web për të drejtuar mbrëmje kuizi: ndërton radhën e programit, e provon dhe pastaj e shfaq në ekran të plotë, ndërsa u jep pikë skuadrave nga një panel kontrolli. Serveri i tij MCP u lejon asistentëve AI si Claude ose ChatGPT të shkruajnë kuize direkt në bibliotekën e organizatorit. Mjafton të kërkosh "një kuiz pubi me 3 raunde për futbollin e viteve '90" dhe kuizi i plotë shfaqet në Quiz Master, gati për t'u drejtuar.
Kush e përdor dhe për çfarë
- Një organizator kuizesh i kërkon Claude-it një mbrëmje me temë dhe merr një kuiz të plotë me raunde, përgjigje dhe renditje.
- Një organizator ndërton në chat një raund me foto ose muzikë, dhe asistenti gjen skedarët dhe i importon në hapësirën e aplikacionit.
- Një organizator ripërdor pyetjet e arkivit të vet në disa mbrëmje, dhe çdo ndryshim shfaqet në të gjitha kuizet që e përdorin pyetjen.
- Gjatë mbrëmjes organizatori e drejton kuizin nga laptopi, ndërsa salla ndjek ekranin me temën e zgjedhur.
Si është ndërtuar
- Server MCP në distancë me 17 mjete të tipizuara dhe të validuara me zod për kuizet, segmentet, arkivin e pyetjeve dhe importin e medias.
- Hyrja bëhet me një rrjedhë të plotë OAuth 2.1, me regjistrim dinamik të klientit dhe PKCE: mjafton URL-ja e serverit, pa çelësa API.
- Serveri nuk ka mjete fshirjeje, dhe çdo kërkesë prek vetëm të dhënat e organizatorit të identifikuar.
- 10 tema të animuara me GSAP për ekranin e publikut. Prezantuesi dhe paneli i kontrollit punojnë në dy dritare, edhe pa internet.
Teknologjitë
Në shifra
- Remote MCP server with 17 typed tools at thequizmaster.app/mcp
- Own OAuth 2.1 authorization server with dynamic client registration, required S256 PKCE and hashed opaque tokens
- Authoring only: no delete tools, and every read or write is scoped to the signed-in host
- 10 presenter themes, 9 question types, 14 timeline segment types
- Media import copies images, audio and video into the app's own storage (25 MB cap, SVG rejected)
- About 118 Vue single-file components. Presenter and control panel stay in sync across two windows via BroadcastChannel
- Keeps working offline mid-quiz thanks to Firestore's persistent multi-tab cache
Mjetet që AI mund të përdorë
| Mjeti | Çfarë bën |
|---|---|
get_authoring_guide | Returns the authoring spec: localized text, segment structure, question and answer shapes, quality guidance. The assistant reads it first. |
list_themes | Lists the presenter themes a quiz can use (Arcade, Cosmos, Quiz Board, Terminus, Chalkboard, ...). |
list_quizzes | Lists the host's quiz templates with languages, theme and per-round question counts. |
get_quiz | Fetches one quiz in full, with the round questions included inline. |
create_quiz | Creates a quiz template; can import a complete running order in one call. |
update_quiz | Patches title, description, theme, languages, settings and metadata. |
add_segment | Inserts a timeline segment (welcome, rules, round, answer reveal, break, scoreboard, ...). A new round gets a matching answer-reveal segment automatically. |
update_segment | Patches one segment's fields. |
remove_segment | Removes a segment and renumbers the timeline. The questions stay in the question bank. |
move_segment | Moves a segment to a new position in the running order. |
search_questions | Searches the host's question bank by text, tags, type and difficulty. |
get_question | Fetches one question in full (prompt, answer, media, clue stages, sub-questions, tags). |
create_question | Creates a standalone question in the question bank, with an optional image, audio clip or YouTube video. |
update_question | Edits a question. The change shows up in every quiz that uses it. |
add_questions_to_round | Adds new inline questions or existing questions from the bank to a round. |
remove_question_from_round | Unlinks a question from a round without deleting it. |
import_media | Copies a remote image, audio or video file into Quiz Master storage and returns a permanent URL. |
MCP


Website


Host app

Player

Të gjitha pamjet tregojnë të dhëna demonstruese të sajuara.