Mozaic MCP server
io.github.MerzoukeMansouri/mozaic·v2.14.3·4 starsMozaic Design System (ADEO): tokens, components, icons, docs and style guides for any agent.
4 stars41 downloads/wk
Reviews
Write oneNobody has reviewed Mozaic yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Mozaic tools (19)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
generate_freemarkerGenerate ready-to-use Freemarker macro code with import statements and configuration examples for Mozaic components.
generate_react_componentGenerate ready-to-use React/TSX code with Mozaic components (@mozaic-ds/react). Returns JSX with proper imports. Use get_component_info first to see available props.
generate_vue_componentGenerate ready-to-use Vue 3 code with Mozaic components (@mozaic-ds/vue-3). Returns <template> with proper imports. Use get_component_info first to see available props.
generate_webcomponentGenerate ready-to-use Web Component code using Mozaic Design System (@mozaic-ds/web-components). Returns HTML with custom elements and import statement.
get_component_infoGet Vue/React component details: props (types, defaults, required), slots, events, and code examples. For CSS-only utilities (Flexy, Margin, Padding), use get_css_utility instead.
get_css_utilityGet CSS utility classes and examples for Mozaic layout and spacing utilities. These are CSS-only utilities (no framework component needed). Available: Flexy (flexbox grid), Container, Margin, Padding, Ratio, Scroll.
get_design_tokensGet Mozaic design tokens with CSS/SCSS variables. Categories: colors (brand, semantic, component), typography (font sizes, weights, line heights), spacing (magic unit scale), shadows, borders, screens (breakpoints), grid (gutters).
get_freemarker_infoGet detailed information about a Freemarker component including configuration options, CSS classes, and usage examples.
get_iconGet a specific Mozaic icon by name with SVG markup and ready-to-use code for React/Vue. Use search_icons first to find icon names.
get_install_infoGet installation commands and import statements for a Mozaic component. Returns package name, install command (npm/yarn/pnpm), import statements, peer dependencies, and quick start code.
get_style_guideGet a specific Mozaic style guide pattern by slug: its description, source site, composed component slugs, and the actual screenshot image. Use list_style_guides first to find slugs.
get_webcomponent_infoGet detailed information about a Mozaic Web Component including attributes, slots, events, CSS custom properties, and usage examples.
list_componentsList Mozaic Vue/React components by category. Returns component names you can use with get_component_info. For CSS utilities (Flexy, Margin), use list_css_utilities instead.
list_css_utilitiesList Mozaic CSS-only utilities (no framework needed). Returns utility names to use with get_css_utility. Layout: Flexy (grid), Container. Utility: Margin, Padding, Ratio, Scroll.
list_freemarkerList available Mozaic Freemarker macros by category. Returns macro names and import paths.
list_style_guidesList Mozaic style guide patterns — real composed UI screens/layouts (not single components) captured from ADEO apps. Optionally filter by category (e.g. data-table, master-detail, modal-confirm) or source site (e.g. elo, sop). Use get_style_guide to see the actual screenshot.
list_webcomponentsList available Mozaic Web Components by category. Returns custom element tag names and descriptions.
search_documentationSearch Mozaic Design System documentation for installation guides, component usage, configuration, styling, tokens, patterns, and best practices. Use this for any question about how to use Mozaic.
search_iconsSearch Mozaic Design System icons by name or type. Returns icon names, types (navigation, media, social, payment), and available sizes (16, 24, 32, 48, 64). Use get_icon for detailed SVG/code output.
Public scan report
scanner v0.1.10 · 2026-09-28 · same rubric, same numbers if you re-run it
- Code scan108 source files scanned25/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitylocal package, no credentials required12/15
- Maintenancelast push 0 days ago15/15
- Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
How Mozaic compares
Against every graded Productivity MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 92/100
- higher than 90% of 1,299 Productivity servers
- Tools
- 19
- the typical Productivity server has 7
- Tools that change things
- 0%
- typical: 0%. Fewer write tools means less an agent can break
- GitHub stars
- 4
- more than 68% of 854 Productivity servers
- Downloads a week
- 41
- more than 29% of 427 Productivity servers with a package
What its tools let an agent do: 15 read · 4 create
Install Mozaic in Claude Code, Cursor or VS Code
Runs npx -y mozaic-mcp-server on your machine. Read the scan report first; the gateway never runs local packages.
claude mcp add mozaic -- npx -y mozaic-mcp-server
What the publisher says
From the Mozaic repository's README, as published. We do not edit it. Read it on GitHub
Mozaic MCP Server
MCP server and agent skills for the Mozaic Design System by ADEO, for any coding agent: Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, ...
📚 Documentation • 🎮 MCP Playground • 🌐 Website
Overview
This package provides two complementary tools for working with the Mozaic Design System in coding agents:
- 🤖 Agent Skills - 8 interactive skills for guided component building and design token usage
- 🔌 MCP Server - Model Context Protocol server with 19 tools for programmatic access to Mozaic resources
HTTP API
Coding agents should use the local stdio server (npx -y mozaic-mcp-server@2, see Quick Start). The HTTP API is a separate, token-protected server for web tools (e.g. v0) that cannot spawn a local process.
Public server: https://mozaic-mcp.m14i.com (Swagger)
Full vs light: the full endpoints proxy to a spawned stdio MCP server and expose all 19 tools. The light endpoints read SQLite directly (no subprocess, faster) and expose 7 tools: getdesigntokens, listcssutilities, getcssutility, searchicons, geticon, liststyleguides, getstyleguide (getstyleguide returns the screenshot as a PNG image block).
Authentication: Authorization: Bearer on every route except /health and /api. Contact me on Slack for a token.
Call a tool: body is {"name": "", "arguments": {...}}.
curl -X POST https://mozaic-mcp.m14i.com/mcp/light/call-tool \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{"name":"search_icons","arguments":{"query":"arrow","limit":5}}'Self-hosting env vars: PORT (3000), AUTHTOKEN, DATABASEPATH (/app/data/mozaic.db), MCPSERVERPATH (/app/dist/index.js), MCP_DEBUG. See DEPLOYMENT.md.
What's Included
Quick Start
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
Mozaic: common questions
- Is Mozaic MCP server safe?
- Yes, by our scan: it is graded A (92/100). Read the Mozaic safety report
- How do I install Mozaic?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does Mozaic need an API key?
- Not as far as the registry entry and our scan can tell: no credentials are declared or required.
- Is Mozaic maintained?
- The last commit was 37 days ago (2026-09-28). The latest release is v2.14.3.
- What can I use instead of Mozaic?
- Servers from other publishers that do the same job: classifier.dev docs MCP server, Starwind UI MCP Server and Arc UI MCP server. Compare all Mozaic alternatives.
- How does Mozaic compare with other Productivity MCP servers?
- safety score 92/100 (higher than 90% of 1,299 Productivity servers); tools 19 (the typical Productivity server has 7); tools that change things 0% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.
Alternatives to Mozaic
Same job from other publishers: the closest match first, then the best rated.
- classifier.dev docsclassifier.dev documentation as tools: list, read and search the reference, benchmark and guides.not reviewedEstablishedA
- Starwind UI MCP ServerFramework-aware Starwind UI v3 tools for Astro and React setup, components, docs, and migration.not reviewedGrowingA
Arc UIReact components and blocks with motion. Search docs, props and shadcn install commands.not reviewedGrowingA- Qiskit Documentation MCP ServerMCP server for querying and retrieving Qiskit documentation, guides, and API referencesnot reviewedGrowingA
- DocsRemote MCP server for Tandem docs, install guides, SDKs, workflows, and agent setup help.not reviewedGrowingA