An MCP server that enables AI assistants to access the Flowbite library of Tailwind CSS components—including UI elements, forms, typography, and plugins—while offering an intelligent theme generator for creating custom branded designs within AI-driven development environments.

MCP Features

• 🎨 60+ UI Components - Complete access to buttons, cards, modals, dropdowns, and more
• 📝 Form Elements - Input fields, checkboxes, radio buttons, select, textarea, and advanced form components
• ✍️ Typography Components - Headings, paragraphs, blockquotes, lists, and text styling
• 🔌 Plugin Integrations - Charts, datatables, WYSIWYG editors, and datepickers
• 🎯 AI-Powered Theme Generator - Create custom branded themes from any hex color
• 📦 Component Source Code - Latest Flowbite Tailwind CSS implementations
• 📋 Metadata Access - Component descriptions, usage patterns, and integration guides
• 🌐 Dual Transport Support - Standard I/O (stdio) for CLI or HTTP Streamable for server deployments
• ⚡ Production Ready - Docker support with health checks and monitoring
• 🎨 Quickstart Guide - Complete setup and integration documentation

Quickstart

Using NPX

The simplest way to use Flowbite MCP Server:

# Run directly with npx (no installation needed)
npx flowbite-mcp

# Show help and options
npx flowbite-mcp --help

# Run in HTTP server mode for production
npx flowbite-mcp --mode http --port 3000

Local Development

For development or running from source:

# Install dependencies
npm install

# Build the project
npm run build

# Run in stdio mode
npm start

# Run in HTTP server mode
npm run start:http

# Development mode with auto-reload
npm run dev

Docker Deployment

For production deployments:

# Run with Docker Compose
docker-compose up -d

# Check health
curl http://localhost:3000/health

Transport Modes

Standard I/O (stdio)

The default mode for local development and CLI integrations:

# Start in stdio mode (default)
node build/index.js

# Configure in Claude Desktop config.json
{
  "mcpServers": {
    "flowbite": {
      "command": "node",
      "args": ["/path/to/flowbite-mcp/build/index.js"]
    }
  }
}

HTTP server

HTTP-based transport for production and multi-client scenarios:

node build/index.js --mode http --port 3000

This will make the MCP server available at 'http://localhost:3000/mcp'.

Environment variables

Configure the server behavior with these environment variables:

# Transport mode: stdio (default) or http
MCP_TRANSPORT_MODE=http

# Server port for HTTP mode
MCP_PORT=3000

# Host binding for HTTP mode
MCP_HOST=0.0.0.0

# CORS origins (comma-separated)
MCP_CORS_ORIGINS=http://localhost:3000,https://myapp.com

Installation & Setup

Make sure that you have the following installed:

• Node.js 16+ installed
• Tailwind CSS v4+ (for generated themes)

Local development

# Clone the repository
git clone https://github.com/themesberg/flowbite-mcp.git
cd flowbite-mcp

# Install dependencies
npm install

# Build the project
npm run build

# Run in stdio mode (for Claude Desktop, Cursor)
npm start

# Run inspector
npm run start inspector

# Run in HTTP server mode (for production/multi-client)
MCP_TRANSPORT_MODE=http npm start

Integration Examples

Claude desktop

Method 1: Using NPX

{
  "mcpServers": {
    "flowbite": {
      "command": "npx",
      "args": ["-y", "flowbite-mcp"]
    }
  }
}

Method 2: Using local Node.js

{
  "mcpServers": {
    "flowbite": {
      "command": "node",
      "args": ["/absolute/path/to/flowbite-mcp/build/index.js"]
    }
  }
}

Cursor editor

With NPX:

{
  "mcpServers": {
    "flowbite": {
      "command": "npx",
      "args": ["-y", "flowbite-mcp"]
    }
  }
}

With Node.js:

{
  "mcpServers": {
    "flowbite": {
      "command": "node",
      "args": ["/absolute/path/to/flowbite-mcp/build/index.js"]
    }
  }
}

Continue.dev

{
  "mcpServers": [
    {
      "name": "flowbite",
      "command": "npx",
      "args": ["-y", "flowbite-mcp"]
    }
  ]
}

Production deployment (HTTP Mode)

For production servers with multiple clients:

# Using npx
npx flowbite-mcp --mode http --port 3000

# Using Docker Compose
docker-compose up -d

# Health check
curl http://localhost:3000/health

Development Scripts

# Build TypeScript to JavaScript
npm run build

# Watch mode for development
npm run watch

# Development with auto-reload
npm run dev

# Run MCP Inspector for debugging
npm run inspector

# Start production server
npm start

Docker Configuration

The project includes a production-ready Docker setup with multi-stage builds for optimal performance.

Quickstart with Docker

# Build and run with Docker Compose (recommended)
docker-compose up -d

# Check health
curl http://localhost:3000/health

# View logs
docker-compose logs -f

# Stop
docker-compose down

MCP inspector

Use the MCP Inspector for interactive debugging:

npm run inspector

Logging

Check server logs for detailed information:

# stdio mode logs to console
node build/index.js

# HTTP mode includes HTTP request logs
MCP_TRANSPORT_MODE=http node build/index.js

File structure

flowbite-mcp/
├── src/
│   ├── index.ts              # Main server entry point
│   └── server-runner.ts      # Express HTTP Streamable transport
├── data/
│   ├── components/           # 60+ component markdown files
│   ├── forms/                # Form component documentation
│   ├── typography/           # Typography elements
│   ├── plugins/              # Plugin documentation
│   ├── theme.md              # Theme variable reference
│   └── quickstart.md         # Getting started guide
├── build/                    # Compiled JavaScript output
├── package.json
├── tsconfig.json
└── README.md

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

1. Fork the repository
2. Create your feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add some AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

License

This project is licensed under the MIT License License - see the LICENSE file for details.

Credits

• Flowbite - For the amazing Tailwind CSS component library
• Anthropic - For the Model Context Protocol specification
• Tailwind CSS - For the utility-first CSS framework

Resources

• 🎨 Flowbite Documentation
• 📦 Flowbite Components
• 🌐 Model Context Protocol
• 🚀 Tailwind CSS v4 Docs
• 💬 GitHub Issues

Roadmap

• [x] Complete component resource access
• [x] AI-powered theme generator
• [x] Dual transport support (stdio + HTTP)
• [ ] Flowbite Pro blocks integration (with license authentication)
• [ ] Figma to code conversion tool
• [ ] Enhanced theme customization options
• [ ] Component search and filtering
• [ ] Real-time component preview generation