Daisyui Mcp

[](https://mseep.ai/app/birdseyevue-daisyui-mcp)

🌼 DaisyUI MCP Server

[](https://python.org) [](https://modelcontextprotocol.io) [](https://www.docker.com/) [](LICENSE)

A token-friendly local MCP server for DaisyUI component documentation

Give your AI assistant the power to build beautiful UIs with DaisyUI 🚀

[Features](#-features) • [Installation](#-installation) • [Docker](#-docker) • [Usage](#-usage) • [Configuration](#-configuration)

---

✨ Features

• 🎯 Token-Efficient — Only exposes relevant context via MCP tools, saving precious tokens
• 📚 60+ Components — Full coverage of 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:

| Tool | Description | | ----------------- | ------------------------------------------------------------------------------------ | | list_components | 📋 Lists all available DaisyUI components with short descriptions | | get_component | 📖 Gets the full documentation for a specific component (classes, syntax, examples) |

> 💡 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.

---

💬 Example Prompts

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/fastmcp.git
cd fastmcp

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

---

🐳 Docker

You can also run the MCP server using Docker.

Build and run with Docker

docker build -t daisyui-mcp .
docker run -i --rm daisyui-mcp

Using Docker Compose

docker compose up --build

The docker-compose.yml mounts the local components/ directory as a volume, so any changes you make to component docs on the host are reflected inside the container.

Docker configuration for AI assistants

📁 Docker Configuration

{
  "servers": {
    "daisyui": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "daisyui-mcp"]
    }
  }
}

---

🚀 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:

📁 Generic Configuration

{
  "servers": {
    "daisyui": {
      "command": "/venv/Scripts/python.exe",
      "args": ["/mcp_server.py"]
    }
  }
}

🪟 Windows Example

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

🍎 macOS/Linux Example

{
  "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)
├── 🐳 Dockerfile             # Docker image definition
├── 🐳 docker-compose.yml     # Docker Compose configuration
└── 📂 components/            # Markdown files for each component
    ├── button.md
    ├── card.md
    ├── modal.md
    ├── table.md
    └── ... (60+ components)

---

🤝 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](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!

Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: birdseyevue
• Source: birdseyevue/daisyui-mcp
• License: MIT

Install and usage instructions live in the source repository linked above.