Flasim për projektin

AI · MCP

The Quiz Master

Aplikacion për kuize pubi, ku shkruan edhe asistenti AI

Roli ynë
Own product: design and full-stack development
Periudha
2026
Statusi
Beta
Pamjet
MCP, Website, Host app, Player

Hap thequizmaster.app

The Quiz Master: MCP në përdorim: një asistent AI ndërton një kuiz me 3 raunde për futbollin e viteve '90 me mjetet e Quiz Master, dhe kuizi del në bibliotekë gati për t'u drejtuar (mockup ilustrues).

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ë

  • Vue 3 + TypeScript
  • Pinia
  • Vite
  • Tailwind CSS v4
  • GSAP
  • Firebase (Auth, Firestore, Storage, Functions, Hosting)
  • Model Context Protocol SDK
  • Express + zod
  • OAuth 2.1 (PKCE, dynamic client registration)

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_guideReturns the authoring spec: localized text, segment structure, question and answer shapes, quality guidance. The assistant reads it first.
list_themesLists the presenter themes a quiz can use (Arcade, Cosmos, Quiz Board, Terminus, Chalkboard, ...).
list_quizzesLists the host's quiz templates with languages, theme and per-round question counts.
get_quizFetches one quiz in full, with the round questions included inline.
create_quizCreates a quiz template; can import a complete running order in one call.
update_quizPatches title, description, theme, languages, settings and metadata.
add_segmentInserts a timeline segment (welcome, rules, round, answer reveal, break, scoreboard, ...). A new round gets a matching answer-reveal segment automatically.
update_segmentPatches one segment's fields.
remove_segmentRemoves a segment and renumbers the timeline. The questions stay in the question bank.
move_segmentMoves a segment to a new position in the running order.
search_questionsSearches the host's question bank by text, tags, type and difficulty.
get_questionFetches one question in full (prompt, answer, media, clue stages, sub-questions, tags).
create_questionCreates a standalone question in the question bank, with an optional image, audio clip or YouTube video.
update_questionEdits a question. The change shows up in every quiz that uses it.
add_questions_to_roundAdds new inline questions or existing questions from the bank to a round.
remove_question_from_roundUnlinks a question from a round without deleting it.
import_mediaCopies a remote image, audio or video file into Quiz Master storage and returns a permanent URL.

MCP

The Quiz Master, MCP: MCP në përdorim: një asistent AI ndërton një kuiz me 3 raunde për futbollin e viteve '90 me mjetet e Quiz Master, dhe kuizi del në bibliotekë gati për t'u drejtuar (mockup ilustrues).
MCP në përdorim: një asistent AI ndërton një kuiz me 3 raunde për futbollin e viteve '90 me mjetet e Quiz Master, dhe kuizi del në bibliotekë gati për t'u drejtuar (mockup ilustrues).
The Quiz Master, MCP: 17 mjetet që ofron serveri MCP: kuize, segmente të programit, arkivi i pyetjeve dhe importi i medias. Asgjë shkatërruese.
17 mjetet që ofron serveri MCP: kuize, segmente të programit, arkivi i pyetjeve dhe importi i medias. Asgjë shkatërruese.

Website

The Quiz Master, Website: Faqja e lidhjes: një URL serveri dhe hyrja me OAuth, pastaj asistenti punon në bibliotekën tënde të kuizeve.
Faqja e lidhjes: një URL serveri dhe hyrja me OAuth, pastaj asistenti punon në bibliotekën tënde të kuizeve.
The Quiz Master, Website: Faqja kryesore në thequizmaster.app.
Faqja kryesore në thequizmaster.app.

Host app

The Quiz Master, Host app: Ndërtuesi i kuizit: programi majtas, pamja paraprake e slajdit në mes, inspektori i pyetjes djathtas.
Ndërtuesi i kuizit: programi majtas, pamja paraprake e slajdit në mes, inspektori i pyetjes djathtas.

Player

The Quiz Master, Player: Çfarë sheh salla: një pyetje me foto në temën Arcade, krahas kontrolleve të organizatorit.
Çfarë sheh salla: një pyetje me foto në temën Arcade, krahas kontrolleve të organizatorit.

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

Do të shkruash lirisht?

Na trego çfarë do të ndërtosh.

Marrim punë të reja: MVP, rindërtime, integrime AI, ose një inxhinier senior në ekipin tënd për një periudhë. Mjaftojnë disa rreshta për idenë që të nisim.

Na shkruaj