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, ...
에이전트 강화
게시자의 자체 명령입니다. PlugMCP 엔드포인트가 아닙니다.
Host a copy with our keys and logs.
npx -y [email protected]Claude Code에는 로컬 명령용 설치 링크가 없습니다. 아래 명령을 복사해 터미널에서 실행합니다.
claude mcp add io.github.merzoukemansouri-mozaic -- npx -y mozaic-mcp-server@2.14.3터미널에서 실행합니다.
{ "mcpServers": { "io.github.merzoukemansouri-mozaic": { "command": "npx", "args": [ "-y", "[email protected]" ] } }}claude_desktop_config.json
원격 URL인가요, 내 컴퓨터에서 실행하는 명령인가요? 두 설치 방식의 차이
PlugMCP에서 실행
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
실행게시자 제공
MCP server and agent skills for the Mozaic Design System by ADEO, for any coding agent: Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, ...
Mozaic Design System (ADEO): tokens, components, icons, docs and style guides for any agent.
📚 Documentation • 🎮 MCP Playground • 🌐 Website
This package provides two complementary tools for working with the Mozaic Design System in coding agents:
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: get_design_tokens, list_css_utilities, get_css_utility, search_icons, get_icon, list_style_guides, get_style_guide (get_style_guide returns the screenshot as a PNG image block).
Authentication: Authorization: Bearer <token> on every route except /health and /api. Contact me on Slack for a token.
Call a tool: body is {"name": "<tool>", "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), AUTH_TOKEN, DATABASE_PATH (/app/data/mozaic.db), MCP_SERVER_PATH (/app/dist/index.js), MCP_DEBUG. See DEPLOYMENT.md.
Works with any coding agent that supports Agent Skills and/or MCP: Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf, VS Code, ...
Two standard, agent-agnostic CLIs. Each detects your agents and writes to the current project by default:
npx skills add MerzoukeMansouri/adeo-mozaic-mcp # 8 skills -> .agents/skills/, .claude/skills/, ...
npx add-mcp mozaic-mcp-server@2 --name mozaic # MCP server -> .mcp.json, .cursor/mcp.json, .vscode/mcp.json, .codex/config.toml, ...
npx skills and npx add-mcp both accept -g (your user instead of the project), -a <agent> (target specific agents) and -y (no prompts).~/.mozaic/mozaic.db) on first use. Refresh it any time with npx -y -p mozaic-mcp-server@2 mozaic-db.npx skills remove <skill> and npx add-mcp remove mozaic.-g): for your user across every project, nothing to commit.npm i -g: agents run the server with npx -y mozaic-mcp-server@2, which stays on major version 2 and picks up fixes.Test all 19 MCP tools directly in your browser, without installation:
8 skills that provide interactive workflows for building with Mozaic.
Skills follow the Agent Skills format (skills/<name>/SKILL.md), so any compatible agent activates them automatically based on context:
User: "I need a login form with Mozaic"
The agent activates the appropriate skill (e.g. Vue or React builder) and guides you through:
See SKILLS.md for detailed documentation.
19 programmatic tools for accessing Mozaic resources via the Model Context Protocol.
npx add-mcp mozaic-mcp-server@2 --name mozaic writes the right file for each agent. The server name must be mozaic (the mozaic-style-guide skill expects it). Manual setup, for example .mcp.json (Claude Code) or .cursor/mcp.json (Cursor):
{
"mcpServers": {
"mozaic": {
"command": "npx",
"args": ["-y", "mozaic-mcp-server@2"]
}
}
}
VS Code uses a servers key in .vscode/mcp.json; Codex uses [mcp_servers.mozaic] in .codex/config.toml.
The server is also published to the MCP Registry as io.github.MerzoukeMansouri/mozaic.
Skills activate automatically based on your request:
You: "I need a responsive grid with 3 columns"
Agent: [activates mozaic-css-utilities skill]
Here's the Flexy grid solution...
You: "Add a shopping cart icon"
Agent: [activates mozaic-icons skill]
I found these cart icons...
When configured, the agent can use MCP tools directly:
You: "What design tokens are available?"
Agent: [calls get_design_tokens tool]
Found 586 tokens across 8 categories...
You: "Generate a React button component"
Agent: [calls get_component_info, then generate_react_component]
Here's your Button component with TypeScript...
Any coding agent
┌──────────────┴──────────────┐
▼ ▼
Skills (8) MCP server (19 tools, stdio)
24 shell scripts + sqlite3 npx -y mozaic-mcp-server@2
│ │
▼ ▼
~/.mozaic/mozaic.db data/mozaic.db (packaged)
Both are the same SQLite database: 586 tokens, 191 components, 1,473 icons, 309 docs, 16 style guides. Skills never need the MCP server: every skill, including mozaic-style-guide (screenshots are stored in the database), works from its scripts alone.
# Clone the repository
git clone https://github.com/MerzoukeMansouri/adeo-mozaic-mcp.git
cd adeo-mozaic-mcp
# Install dependencies
pnpm install
# Build the project (compiles TypeScript + builds database)
pnpm build
# Run tests
pnpm test
# Start MCP server in debug mode
pnpm start:debug
mozaic-mcp-server/
├── src/ # TypeScript source code
│ ├── index.ts # stdio MCP server entry point
│ ├── main.ts # NestJS HTTP server entry point
│ ├── tools/ # MCP tool implementations
│ ├── mcp/ # HTTP controllers (full + light)
│ ├── parsers/ # Source repo parsers
│ └── db/ # Schema and queries
├── skills/ # Agent Skills (SKILL.md)
│ ├── mozaic-vue-builder/
│ │ ├── SKILL.md # Skill instructions
│ │ └── scripts/ # Shell scripts
│ └── ... # Other skills
├── scripts/ # Build and utility scripts
│ ├── build-index.ts # Database builder
│ ├── sanity-check.ts # Database sanity check
│ └── generate-docs.ts # Documentation generator
├── data/ # Generated database
│ └── mozaic.db
├── repos/ # Source repos, cloned by `pnpm build` (gitignored)
├── style-guides/ # Hand-authored patterns (meta.json + screenshot.png)
├── bin/mozaic-db.js # installs the skills database to ~/.mozaic/mozaic.db
└── website/ # Documentation website
pnpm build compiles TypeScript, then clones (or pulls) the source repos into repos/ and builds data/mozaic.db:
adeo/mozaic-design-system (public): tokens, icons, docsadeo/mozaic-vue, mozaic-react, mozaic-web-components, mozaic-freemarker (private, need GitHub access)style-guides/<slug>/ (in this repo)Check it with pnpm database:sanity.
Contributions are welcome! Please follow these guidelines:
git checkout -b feature/amazing-feature)git push origin feature/amazing-feature)We use semantic versioning with conventional commits:
feat: - New feature (minor version bump)fix: - Bug fix (patch version bump)feat!: or BREAKING CHANGE: - Breaking change (major version bump)chore:, docs:, style:, refactor:, test: - No version bumpMIT License - see LICENSE file for details.
For issues or questions:
Built with ❤️ for the ADEO community
Mozaic Design System is maintained by ADEO
Mozaic Design System (ADEO): tokens, components, icons, docs and style guides for any agent.
{ "mcpServers": { "io.github.merzoukemansouri-mozaic": { "command": "npx", "args": [ "-y", "[email protected]" ] } }}도구
아직 도구 목록이 없습니다. 원격 서버는 첫 상태 확인 후에 도구 목록이 생깁니다.
FAQ
이 페이지에서 Cursor, Claude Desktop, Claude Code 또는 VS Code용 stdio 설정을 복사합니다. PlugMCP 프록시가 아니라 게시자의 설치 방식을 사용합니다.
이 레코드에는 필수 환경 변수가 등록되어 있지 않습니다.
Mozaic은(는) stdio를 통해 로컬에서 실행됩니다.
마지막 확인: 2026-11-09. Mozaic Design System (ADEO): tokens, components, icons, docs and style guides for any agent.