Skip to content

connorads/lumo-mcp-app

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

33 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Lumo Fox

Lumo

See it click.

A tutor in your chat that draws diagrams you click to explore deeper.


Lumo is an interactive visual AI tutor built as an MCP App. Ask it to teach you anything and it creates a live, adaptive lesson — diagrams, mind maps, quizzes, and fill-in-the-blank exercises — all inside the chat.

How it works

Lumo follows a learning spiral guided by Bloom's taxonomy:

Explore → Interact → Drill → Check → Adapt → Suggest
  1. Explore — the model draws an interactive diagram or mind map
  2. Interact — you click a node to drill deeper
  3. Check — a quiz or fill-in-the-blank tests your understanding
  4. Adapt — correct answers advance; wrong answers trigger a different explanation
  5. Suggest — the model offers adjacent topics to continue

No fixed endpoint — the session flows naturally until you stop.

Widgets

Widget What it does Bloom's level
lumo-sketch Interactive Mermaid.js diagrams — flowcharts, sequence, state, and class diagrams with clickable nodes Remember / Understand
lumo-map Zoomable, pannable mind maps from Markdown headings — click any branch to explore Remember
lumo-quiz Multiple-choice questions testing recognition Remember / Understand
lumo-recall Fill-in-the-blank exercises testing active recall from memory Apply / Analyse

Tech stack

TypeScript · React 19 · Skybridge · MCP protocol · Mermaid.js · Markmap · Zod · Vite · Vitest

Development

npm install
npm run dev    # MCP server + devtools at localhost:3000
npm test       # run tests

Credits

Built for Claude Code London Hack Night 03 (20 Feb 2026) using Claude Code.

Powered by the Skybridge framework and the MCP Apps specification.

About

Lumo 🦊 MCP app that teaches any concept with interactive diagrams, mind maps, quizzes, and fill-in-the-blank exercises inside your chat

Topics

Resources

Stars

Watchers

Forks

Contributors