Daisyui MCP

🚀 DaisyUI MCP Server

A token-friendly local MCP server for DaisyUI component documentation, empowering your AI assistant to build beautiful UIs with DaisyUI.

🚀 Quick Start

The DaisyUI MCP Server is a powerful tool that allows your AI assistant to leverage DaisyUI's component library. To get started, follow the installation steps below and start using it right away.

✨ Features

• 🎯 Token-Efficient: Only exposes relevant context via MCP tools, saving precious tokens.
• 📚 60+ Components: Fully covers DaisyUI's component library.
• 🔄 Auto-Updatable: Fetch the latest docs anytime with one command.
• ✏️ Customizable: Edit or add your own component docs to fit your project.
• ⚡ Fast & Lightweight: Built with FastMCP for optimal performance.

🛠️ MCP Tools

This server exposes two tools that AI assistants can use:

💡 The component docs are pulled from daisyui.com/llms.txt and stored locally as markdown files. This way you can also add your own custom components or edit existing ones to your liking or project needs.

💻 Usage Examples

Basic Usage

Try asking your AI assistant:

"What DaisyUI components are available?"

"Implement a responsive card grid using DaisyUI"

"How does the modal component work? Show me an example"

📦 Installation

1. Clone the repository

git clone https://github.com/birdseyevue/daisyui-mcp.git
cd daisyui-mcp

2. Create a virtual environment (recommended)

python -m venv venv

# Windows
venv\Scripts\activate

# macOS/Linux
source venv/bin/activate

3. Install dependencies

pip install -r requirements.txt

🚀 Usage

First-time setup

Upon first run, the MCP server will not have any component docs. Fetch them by running:

python update_components.py

This fetches the latest llms.txt from DaisyUI and generates all the markdown files in /components.

Running the server

python mcp_server.py

Updating component docs

If DaisyUI releases new components or updates their docs, simply run:

python update_components.py

⚙️ Configuration

Add the MCP server to your AI assistant's configuration:

{
  "servers": {
    "daisyui": {
      "command": "<path-to-repo>/venv/Scripts/python.exe",
      "args": ["<path-to-repo>/mcp_server.py"]
    }
  }
}

{
  "servers": {
    "daisyui": {
      "command": "C:/Users/username/Downloads/fastmcp/venv/Scripts/python.exe",
      "args": ["C:/Users/username/Downloads/fastmcp/mcp_server.py"]
    }
  }
}

{
  "servers": {
    "daisyui": {
      "command": "/home/username/fastmcp/venv/bin/python",
      "args": ["/home/username/fastmcp/mcp_server.py"]
    }
  }
}

📁 Project Structure

fastmcp/
├── 🐍 mcp_server.py          # The MCP server
├── 🔄 update_components.py   # Script to fetch/update component docs
├── 📋 requirements.txt       # Dependencies (just fastmcp)
└── 📂 components/            # Markdown files for each component
    ├── button.md
    ├── card.md
    ├── modal.md
    ├── table.md
    └── ... (60+ components)

❗ Disclaimer

Note: DaisyUI has an official Blueprint MCP ($600 lifetime) with premium features.

This project is not that. It's a free, DIY alternative using their publicly available documentation.

• ✅ No extra features
• ✅ No competition
• ✅ Just a personal tool I wanted to share!

If you want an official experience with premium features, consider supporting DaisyUI by purchasing their Blueprint MCP!

🤝 Contributing

Contributions are welcome! Feel free to:

• 🐛 Report bugs
• 💡 Suggest new features
• 📝 Improve documentation
• 🔧 Submit pull requests

📄 License

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

Free to use, modify, and distribute! Have fun! 🎉

Made with ❤️ for the DaisyUI community

⭐ Star this repo if you find it useful!