About Lumo
Lumo is an MCP server in the Social category: mobile UI/UX design intelligence for AI coding assistants. Deterministic Python tools: WCAG + OKLCH auto-correct, Fitts/Hick/Gestalt layout checks, Compose+SwiftUI AST audit, Figma render/diff, cross-platform parity. MCP server, 11 functions, 5 install paths.
Install
git clone https://github.com/OneXeor-Dev/lumoThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Tools (9)
lumo-auditWhole-repository scan. Walks every `.kt` / `.swift` file, aggregates `lumo-source` findings, and surfaces the *measured* spacing / radius scale — the actual frequency of every hardcoded literal in the codebase. Lets you compare what your design system claims against what the code actually does.
Parameters not published.
lumo-figma diffDiff Figma design tokens (COLOR + FLOAT variables) against the audited code. Matches by value, not name. Three buckets: matched, unused-in-code (candidates for review), and missing-from-Figma (heavy code values waiting to be promoted to the design system).
Parameters not published.
lumo-figma renderRender a Figma frame to a Lumo layout JSON with `source: "measured"` — Figma's `absoluteBoundingBox` is the rendered coordinate after Auto-Layout resolves. Lets `lumo-theory` / `lumo-parity` run on the design itself BEFORE any code ships. No more hand-built layout JSON for design audits.
Parameters not published.
lumo-mcpModel Context Protocol server. Exposes all of the above to Claude Code, Cursor, Continue, Aider, Goose, Zed, OpenAI Codex CLI, and any other MCP-aware client.
Parameters not published.
lumo-parityCross-platform diff between Android (Compose / XML, in dp) and iOS (SwiftUI / UIKit, in pt). Flags size and component mismatches. Whitelists known platform divergences (Material 48 dp vs Apple HIG 44 pt, etc.) so the noise stays out. Optional `lumo.config.json` validates both platforms against shared design tokens.
Parameters not published.
lumo-renderAST layout evaluator for Compose `.kt` and SwiftUI `.swift`. Produces measured-like `(x, y, w, h)` coordinates from source with no build, no app run, no snapshot test. Output feeds `lumo-theory` and `lumo-parity` directly. Honest about what it can't derive: token references and unknown composables come back as `ast-unresolved` with a reason, never invented numbers. New honesty label slot: `measured > ast-resolved > code-estimated > description-estimated`.
Parameters not published.
lumo-sourceAST-based design-system drift checks for Jetpack Compose `.kt` and SwiftUI `.swift` files. Flags hardcoded colours, off-scale paddings / radii, and undersized tap targets (Material 48dp on Compose, Apple HIG 44pt on SwiftUI) — but never trips on theme tokens (`MaterialTheme.*`, `LocalDimensions.*`, `Color("brand…")`, asset-catalog lookups) since those are exactly what Lumo wants to encourage.
Parameters not published.
lumo-theoryCognitive-science layout checks: undersized tap targets, relative Fitts difficulty for primary actions, Hick overload in equal-weight choice groups, Gestalt proximity violations, one-handed reachability.
Parameters not published.
lumo-wcagWCAG AA / AAA contrast checker + OKLCH auto-correct that preserves chroma and hue. Catches the contrast pairs Claude misjudges by eye.
Parameters not published.
Ask AI
Ask AI about Lumo
Powered by Claude · Grounded in docs
Security checks
6 checks have not been run yet.