io.github.anousss007/ng-blatui MCP Server
io.github.anousss007/ng-blatui
Search 157 Angular components, 16 blocks, 70 charts & 35 templates with typed API docs via MCP.
What this kind of tool is for
- Scaffold, lint, or restyle a component your agent is already editing.
- Run accessibility, link, or screenshot checks against a local build.
- Turn a design constraint into generated markup the agent can iterate on.
How to compare servers like this
- Framework fit:
- Check the tool targets your stack (React, Vue, plain HTML) before installing it.
- Runtime needs:
- Some browser-driving tools need a local browser or display; read the setup notes first.
- Maintenance signal:
- Frontend tooling churns quickly; recent commits are a good filter.
- Output quality:
- Prefer tools whose generated code you would accept into the repo as-is.
This page carries your copy-paste config: pick your MCP client in the install section on this page and use the copy button.
What is the io.github.anousss007/ng-blatui MCP server?
The ng-blatui MCP server provides tools to search and retrieve documentation for ng-blatui, an accessible Angular UI library with 157 components, 16 blocks, 70 charts, and 35 page templates. It exposes capabilities to list components by category, search the catalog, and fetch full API documentation and code examples for any component.
ng-blatui is a comprehensive Angular UI library built on Angular Aria, CDK, and Tailwind CSS v4. This MCP server lets AI agents discover and use the component catalog correctly by exposing search, listing, and documentation-fetching tools. Use it to help Claude or other AI assistants build Angular UIs faster by giving them direct access to the full ng-blatui catalog, API signatures, and code examples.
How to install io.github.anousss007/ng-blatui
Copy-paste configuration for popular MCP clients.
{
"mcpServers": {
"ng-blatui": {
"url": "https://ngblatui.remix-it.com/mcp"
}
}
}Tools & capabilities
Tools this server exposes to the agent.
list_components— List all 157 components, optionally filtered by category.list_blocks— List all 16 pre-built blocks (common UI patterns).list_charts— List all 70 chart components.list_templates— List all 35 production-style page templates.search— Search the entire catalog by query string.get_docs— Fetch full documentation, API reference, and code examples for a named component.
Use cases
- Quickly find the right Angular component for a UI task and get its full API signature and usage examples.
- Search the ng-blatui catalog by feature (e.g., 'date picker', 'form field') to discover relevant components.
- Retrieve pre-built blocks and page templates to accelerate Angular app development.
- Get localization and theming options for any component to match your app's design system.
- Explore 70 chart components with their configuration options for data visualization.
io.github.anousss007/ng-blatui MCP server FAQ
It's a Model Context Protocol server that gives AI agents like Claude access to the ng-blatui component library catalog. It exposes tools to list, search, and fetch full documentation for 157 components, 16 blocks, 70 charts, and 35 page templates.
Yes. ng-blatui is MIT-licensed open-source software published on npm. The MCP server is also free and open-source.
Run `claude mcp add ng-blatui -- npx -y ng-blatui-mcp` or add the config to your MCP client: `{ "mcpServers": { "ng-blatui": { "command": "npx", "args": ["-y", "ng-blatui-mcp"] } } }`.
No. The MCP server requires no API keys or authentication. It works locally and connects to the public ng-blatui documentation.
Angular 21 and 22. Peer dependencies include @angular/core, @angular/common, @angular/forms, @angular/cdk, and @angular/aria.
Yes. Every form control implements ControlValueAccessor, so they work with Reactive, Template-driven, and Signal forms out of the box.
README (reference)
Source of truth, from the repository.
ng-blatui
Accessible Angular UI library — a faithful port of BlatUI's visual system to Angular. Built on the official Angular headless stack (Angular Aria + CDK), styled with Tailwind CSS v4 + oklch design tokens.
157 components · 16 blocks · 70 charts · 35 page templates — all standalone, signal-based, zoneless and SSR-safe.
🔗 Docs & live demo → · 📦 npm · 🤖 Using with AI →
Highlights
- Angular 21 & 22 — standalone components, signals (
input()/model()/output()), zoneless change detection,OnPushby default. - SSR-ready — every component renders correctly under server-side rendering (the docs site prerenders 280+ static routes).
- Accessible — behavior built on
@angular/aria+@angular/cdk; passes AXE / WCAG AA. - Forms-native — every form control implements
ControlValueAccessor, so the same component works with Reactive, Template-driven and Signal forms. - Themeable — Tailwind v4 utilities + CSS variables (oklch tokens); light/dark out of the box.
- AI-ready — ships an MCP server, an
llms.txtindex and a machine-readable registry (see below).
Installation
npm i ng-blatui
Peer dependencies (Angular 21 or 22): @angular/core, @angular/common, @angular/forms, @angular/cdk, @angular/aria.
Tailwind CSS setup
Styling is Tailwind CSS v4. In your app's global stylesheet (e.g. src/styles.css) add three lines:
@import 'tailwindcss';
@import 'ng-blatui/foundations/blatui.css'; /* design tokens + dark theme */
@source '../node_modules/ng-blatui'; /* ← generate the utilities the lib's classes use */
The @source line is the easy one to miss: without it Tailwind never scans ng-blatui's
compiled templates, so the components render unstyled. Point it at wherever ng-blatui lives
relative to the stylesheet (adjust the ../ depth). Dark mode is a dark class on a parent
(<html class="dark">); override any oklch token in :root / .dark to re-theme. Full guide:
https://ngblatui.remix-it.com/docs/installation.
Icons
ng-blatui ships no icon set — wire your own (e.g. @ng-icons)
with provideIcons(...) and register each icon you use. Components that take an icon accept an SVG
path d string, so any icon source works.
Usage
Import the component class from the ng-blatui barrel and add it to a standalone component's imports[] — no NgModule. Selectors are prefixed bui.
import { Component } from '@angular/core';
import { BuiButton, BuiBadge, BuiInput } from 'ng-blatui';
@Component({
selector: 'app-demo',
imports: [BuiButton, BuiBadge, BuiInput],
template: `
<label>
Email
<input buiInput type="email" placeholder="you@example.com" />
</label>
<button buiButton>Save <span buiBadge tone="success">New</span></button>
`,
})
export class Demo {}
- Element selectors:
<bui-avatar>,<bui-rating>, … - Attribute/directive selectors:
<button buiButton>,<input buiInput>,<span buiBadge tone="success">, … - Signals: bind
[checked]/(checkedChange)etc.; works under zoneless CD and SSR with no extra setup. - Forms:
formControlName,[(ngModel)]or[formControl]all work — every control is aControlValueAccessor.
Form fields: two levels
- Batteries-included components wire label + hint + error + ARIA for you:
BuiInputField,BuiMoneyInput(localized currency;symbol="DH"overrides the ISO code),BuiDateRangePicker(start→end with presets), plusBuiSelect,BuiCombobox,BuiAutocomplete,BuiPhoneInput. - Composition primitives for custom layouts:
buiField+buiFieldLabel/buiFieldDescription/buiFieldErrorwrap a barebuiInput/.blat-*control and manage the a11y relationships.
Reach for a bare control (buiInput) only when you also add the buiField scaffolding yourself.
Other easy-to-miss building blocks: buiEmpty (empty states), bui-stat (stat cards),
buiFieldSet / buiFieldLegend (grouped fields).
Theming
Styling is Tailwind v4 + CSS variables. Override the oklch design tokens (--background, --foreground, --primary, --border, --muted, --radius, …) to restyle everything globally; toggle a dark class for dark mode. See https://ngblatui.remix-it.com/docs/theming.
Localization
Two providers cover the whole library, both set once in your app config:
import { provideBuiLabels, provideBuiLocale } from 'ng-blatui';
providers: [
provideBuiLocale('fr-BE'), // dates, times, numbers, week start, weekend, week numbering
provideBuiLabels({ fileUploadRemove: 'Supprimer le fichier' }), // built-in strings
];
Set neither and everything formats as en-US — that is Angular's own LOCALE_ID default, and
the usual reason pickers stay American in an app that is not. Resolution runs most-specific first:
a component's [locale] input → provideBuiLocale() → the app's LOCALE_ID → en-US. You never
need registerLocaleData() here; ng-blatui formats through Intl.
Both providers also take a signal, or a factory run in an injection context — which is what keeps them open to any translation library (Transloco, ngx-translate, a signal store of your own) without ng-blatui depending on one, or knowing any translation format. Full guide, with a Transloco example: https://ngblatui.remix-it.com/docs/localization.
What's inside
| Category | Count | Browse |
|---|---|---|
| Components | 157 | https://ngblatui.remix-it.com/components |
| Blocks | 16 | https://ngblatui.remix-it.com/blocks |
| Charts | 70 | https://ngblatui.remix-it.com/charts |
| Templates | 35 | https://ngblatui.remix-it.com/templates |
Templates are full, production-style pages (dashboard, pricing, auth, store, CRM, blog, docs, e-commerce product, plus 20 art-directed landing pages) — faithful 1:1 reproductions of the BlatUI originals.
Using with AI agents
ng-blatui is built to be consumed by AI coding assistants so they discover and use the catalog correctly instead of guessing — via three layers:
| Layer | What | Where |
|---|---|---|
| MCP server | Tools to list/search the catalog and fetch full docs + code | npx ng-blatui-mcp |
| llms.txt | The llms.txt standard index | https://ngblatui.remix-it.com/llms.txt |
| registry.json | Machine-readable catalog | https://ngblatui.remix-it.com/registry.json |
Quick start (works in Claude, Cursor, Windsurf, Cline, Zed, VS Code…):
claude mcp add ng-blatui -- npx -y ng-blatui-mcp
# or add to any MCP client:
# { "mcpServers": { "ng-blatui": { "command": "npx", "args": ["-y", "ng-blatui-mcp"] } } }
The MCP server exposes list_components (optional category), list_blocks, list_charts, list_templates, search({ query }) and get_docs({ name }). Full guide with per-client config and copy-paste editor rules: USING-WITH-AI.md.
Development
This is an Angular workspace with two projects: the library (projects/ng-blatui) and the docs/demo app (projects/demo).
git clone https://github.com/anousss007/ng-blatui.git
cd ng-blatui
npm install
npm start # serve the docs/demo app at http://localhost:4200
Scripts
| Command | What it does |
|---|---|
npm start | Serve the demo app (ng serve demo) |
npm run build:lib | Build the publishable library (ng build ng-blatui) |
npm run build | Build the demo site |
npm test | Unit tests (Vitest) |
npm run lint | ESLint (type-aware, strict) + template a11y |
npm run format | Prettier (with Tailwind class sorting) |
npm run build:registry | Regenerate registry.json + llms.txt from the catalog |
npm run capture:previews | Capture template preview images (Playwright) |
npm run deploy:site | Build + deploy the docs site to the VPS |
Project structure
projects/
ng-blatui/ # the published library (src/lib/* = 157 component dirs, public-api.ts)
demo/ # docs + live demo site (components/blocks/charts/templates galleries)
src/app/pages/templates/ # the 35 page templates
public/ # static assets incl. generated llms.txt + registry.json
scripts/
build-registry.mjs # generates registry.json + llms.txt + mcp/registry.json
capture-previews.mjs # template preview screenshots
deploy-site.sh # build + rsync to VPS
mcp/ # the ng-blatui-mcp MCP server package (published separately)
.claude/skills/ # angular-best-practices (contributing) + ng-blatui (consuming)
AGENTS.md # guide for AI agents working IN this repo
USING-WITH-AI.md # guide for consuming ng-blatui WITH an AI agent
Conventions
Angular v22, zoneless, standalone (defaults — never set explicitly). Signals everywhere; native control flow (@if/@for/@switch); no *ngIf/ngClass. Library selector prefix bui, demo prefix app. See AGENTS.md and CONTRIBUTING.md for the full ruleset.
Releasing
- Library (
ng-blatui) — the Release GitHub Actions workflow (manual dispatch) runssemantic-release: it analyzes Conventional Commits, bumps the version, tags, creates a GitHub release and publishes to npm with provenance. - MCP server (
ng-blatui-mcp) — bumpmcp/package.json, then run the Release MCP workflow (manual dispatch) to publish it.
Credits
Angular port of BlatUI (Blade/Laravel + Tailwind component system). Behavior on Angular Aria + CDK.
License
Related MCP servers

shadcn/ui for Laravel Blade — discover, read and install BlatUI components, blocks and charts.
Cinematic website prompts as slash commands, tuned for Lovable, Bolt, Cursor and Claude.

Deploy a web game to a playable multiplayer URL with rooms, state sync, and leaderboards.

io.github.antvis/mcp-server-chart
Generate 26+ chart types and diagrams for AI agents via AntV's MCP server.
AI-agent economic protocol over MCP — identity, reputation, tasks, credit, Sybil resistance
Economic protocol for AI agents — identity + reputation + credit + Sybil resistance (MCP bridge)
View repository →

