Basecoat UI MCP
Provides access to a library of 77 pre-built Basecoat CSS UI components across forms, layout, navigation, feedback, and interactive categories, with comprehensive documentation and usage guides.
Enables retrieval of Basecoat CSS components built on Tailwind CSS v4, including setup code with CDN links and theme switching functionality for dark/light mode support.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Basecoat UI MCP show me a primary button component"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Basecoat UI MCP
A Model Context Protocol (MCP) server that provides Claude and other AI assistants with access to a comprehensive library of Basecoat CSS UI components. This server enables AI assistants to retrieve pre-built, accessible HTML components and usage documentation for building user interfaces.
Features
77 Pre-built Components - Production-ready HTML components across 5 categories
7 MCP Tools - List, search, retrieve components and documentation
Comprehensive Docs - 25 detailed usage guides with examples
Dark/Light Mode - Built-in theme switching support
Accessibility First - All components include proper ARIA attributes
Related MCP server: Components Build MCP
Requirements
Node.js >= 18.0.0
npm (included with Node.js)
Installation
Option 1: Clone from GitHub
git clone https://github.com/Sorbh/basecoat-ui-mcp.git
cd basecoat-ui-mcp
npm installOption 2: Install via npm
npm install -g basecoat-ui-mcpConfiguration
Claude Desktop
Add the server to your Claude Desktop configuration file:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"basecoat-ui": {
"command": "node",
"args": ["/absolute/path/to/basecoat-ui-mcp/server.js"],
"env": {}
}
}
}If installed globally via npm:
{
"mcpServers": {
"basecoat-ui": {
"command": "basecoat-ui-mcp",
"env": {}
}
}
}After updating the config, restart Claude Desktop to load the MCP server.
Other MCP Clients
The server uses standard I/O (stdio) transport and is compatible with any MCP-compliant client. Start the server with:
node server.jsAvailable Tools
The MCP server provides 7 tools that AI assistants can use:
list_components
List all available Basecoat components organized by category.
No parameters requiredReturns a complete inventory of all 77 components with names, categories, and filenames.
get_component
Retrieve the HTML code for a specific component.
Parameter | Type | Required | Description |
| string | Yes | Component name (e.g., "button-primary", "card-basic") |
Example names:
button-primary,button-secondary,button-destructivecard-basic,card-with-iconinput-with-label,input-invalidalert-success,alert-error
get_usage
Get comprehensive usage documentation for a component type.
Parameter | Type | Required | Description |
| string | Yes | Component type (e.g., "button", "card", "input") |
Returns detailed markdown documentation with examples, variants, and best practices.
get_setup
Retrieve Basecoat CSS setup code with CDN links.
No parameters requiredReturns the HTML boilerplate to initialize Basecoat CSS in a new project:
<!-- Tailwind CSS -->
<script src="https://cdn.jsdelivr.net/npm/@tailwindcss/browser@4"></script>
<!-- Basecoat CSS -->
<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/basecoat-css@0.3.1/dist/basecoat.cdn.min.css">
<script src="https://cdn.jsdelivr.net/npm/basecoat-css@0.3.1/dist/js/all.min.js" defer></script>get_theme_script
Get the theme switcher script for dark/light mode.
No parameters requiredReturns a complete JavaScript implementation for theme switching with localStorage persistence.
search_components
Search for components by name or category.
Parameter | Type | Required | Description |
| string | Yes | Search term (e.g., "button", "form", "navigation") |
Returns matching components with match type (name or category match).
get_category
Get all components in a specific category.
Parameter | Type | Required | Description |
| string | Yes | One of: |
Component Library
Forms (20 components)
Component | Description |
| Primary action button |
| Secondary action button |
| Destructive/danger button |
| Ghost/transparent button |
| Outlined button |
| Link-styled button |
| Large sized button |
| Small sized button |
| Icon-only button |
| Large icon button |
| Grouped buttons |
| Basic text input |
| Input with label |
| Input with error state |
| Grouped inputs |
| Basic checkbox |
| Checkbox with label |
| Checkbox with description |
| Radio button group |
| Select dropdown |
| Text area input |
| Toggle switch |
| Range slider |
| Form label |
Layout (17 components)
Component | Description |
| Basic card container |
| Card with icon |
| Standard card layout |
| Data table |
| Small avatar |
| Medium avatar |
| Large avatar |
| Avatar with fallback |
| Pagination controls |
| Basic loading skeleton |
| Profile loading skeleton |
| Card loading skeleton |
| Loading spinner |
| Empty state display |
| Keyboard key element |
| List item |
Navigation (6 components)
Component | Description |
| Expandable accordion |
| Basic breadcrumb |
| Advanced breadcrumb |
| Sidebar navigation |
| Tab navigation |
| Command palette |
Feedback (13 components)
Component | Description |
| Standard alert |
| Error/destructive alert |
| Success alert |
| Primary badge |
| Secondary badge |
| Destructive badge |
| Outlined badge |
| Standard dialog |
| Modal dialog |
| Alert dialog |
| Toast notification |
| Progress bar |
Interactive (8 components)
Component | Description |
| Searchable select |
| Dropdown menu |
| Popover element |
| Standard tooltip |
| Bottom tooltip |
| Right tooltip |
| Dark/light mode toggle |
Usage Examples
Example 1: Building a Form
Ask Claude:
"Create a login form using Basecoat components"
Claude will use the MCP tools to:
Get the
input-with-labelcomponent for email/password fieldsGet the
button-primarycomponent for the submit buttonGet the
checkbox-with-labelfor "Remember me"Combine them into a complete, accessible form
Example 2: Adding Notifications
Ask Claude:
"How do I add toast notifications to my app?"
Claude will use:
get_usagewith "toast" to get documentationget_componentwith "toast" to get the HTMLget_setupto ensure you have the required scripts
Example 3: Searching for Components
Ask Claude:
"What button components are available?"
Claude will use search_components with "button" to list all button variants.
Running the Server
Start the server
npm startDevelopment mode (auto-restart on changes)
npm run devRun tests
npm testVerbose test output
npm run test:verboseProject Structure
basecoat-ui-mcp/
├── server.js # Main MCP server implementation
├── server.test.js # Test suite
├── package.json # Node.js configuration
├── style-guide.md # Comprehensive styling guide
├── claude_desktop_config.json # Example Claude config
│
├── components/ # 77 HTML component files
│ ├── forms/ # Form components
│ ├── layout/ # Layout components
│ ├── navigation/ # Navigation components
│ ├── feedback/ # Feedback components
│ └── interactive/ # Interactive components
│
├── usage/ # 25 markdown documentation files
│ ├── forms/
│ ├── layout/
│ ├── navigation/
│ ├── feedback/
│ └── interactive/
│
└── scripts/ # Setup and theme scripts
├── setup.html # CDN setup code
└── theme-script.html # Theme switcher scriptAbout Basecoat CSS
Basecoat CSS is a modern component library built on Tailwind CSS v4. It provides:
Semantic HTML components with proper accessibility
CSS custom properties for theming
Dark mode support out of the box
Minimal JavaScript for interactive components
WAI-ARIA compliant components
Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
Fork the repository
Create your feature branch (
git checkout -b feature/amazing-feature)Commit your changes (
git commit -m 'Add some amazing feature')Push to the branch (
git push origin feature/amazing-feature)Open a Pull Request
Testing
The project includes comprehensive tests covering:
Component retrieval and validation
Category filtering and organization
Search functionality
Documentation availability
Error handling and edge cases
Performance benchmarks
Run the full test suite:
npm testLicense
MIT License - see LICENSE for details.
Author
Saurabh K. Sharma - GitHub
Links
Available Tools
7 toolsget_categoryC
Get all components in a specific category
Inputs: category (required).
get_componentC
Get HTML code for a specific Basecoat component
Inputs: name (required).
get_setupB
Get Basecoat CSS setup code with CDN links
Inputs: no named parameters.
get_theme_scriptB
Get theme switcher script for dark/light mode
Inputs: no named parameters.
get_usageC
Get usage documentation for a component
Inputs: component (required).
list_componentsB
List all available Basecoat components organized by category
Inputs: no named parameters.
search_componentsC
Search for components by name or category
Inputs: query (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 7 tools
Every tool has a clearly distinct purpose with no ambiguity. For example, get_component retrieves HTML code, get_usage provides documentation, and list_components organizes components by category, making it easy for an agent to select the right tool without confusion.
All tool names follow a consistent verb_noun pattern using snake_case, such as get_category, list_components, and search_components. This predictability enhances readability and usability across the entire tool set.
With 7 tools, the count is well-scoped for a UI component library server. Each tool serves a specific function, such as retrieving components, documentation, or setup code, without being too sparse or overwhelming.
The tool surface covers core workflows like listing, searching, and retrieving components and documentation, with minor gaps such as no update or delete operations for components. However, these are likely unnecessary given the static nature of a UI library, and agents can work effectively with the provided tools.
Maintenance
Related MCP Connectors
Find UI components and themes, retrieve code, and generate with hosted 21st AI when enabled.
Free premium UI components in plain HTML, CSS and vanilla JS, for AI coding assistants.
500+ typed UI atoms an agent composes into real rendered interfaces. Free, no API key.
Accessible React components, tokens, usage guidance, and install commands for product interfaces.
Related MCP Servers
- AlicenseAqualityDmaintenanceProvides reference information for Flux UI components, enabling AI assistants to access component documentation and examples from the Flux UI design system.493MIT
- AlicenseBqualityDmaintenanceProvides AI assistants with tools to grade, generate, and validate UI components against the components.build specification. Supports searching documentation, checking compliance, and generating framework-agnostic accessible components.1124 npmApache 2.0
- FlicenseNot gradedqualityDmaintenanceProvides AI assistants with access to a production-ready design system including Tailwind CSS component patterns, style guides (colors, typography, spacing), and Web Components specifications for consistent UI development.-
- AlicenseAqualityBmaintenanceProvides programmatic access to 30+ Basecoat CSS (HTML port of ShadCN UI) components with usage documentation, setup scripts, and theme switching code. Enables AI assistants to help developers build accessible HTML interfaces with forms, navigation, feedback, interactive, and layout components.772 npm16MIT