# Daisyui Mcp

> 🌼 A token-friendly local MCP server for DaisyUI component documentation using their public llms.txt.

- **Type:** MCP server
- **Install:** `agentstack add mcp-birdseyevue-daisyui-mcp`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [birdseyevue](https://agentstack.voostack.com/s/birdseyevue)
- **Installs:** 0
- **Category:** [Integrations](https://agentstack.voostack.com/c/integrations)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [birdseyevue](https://github.com/birdseyevue)
- **Source:** https://github.com/birdseyevue/daisyui-mcp

## Install

```sh
agentstack add mcp-birdseyevue-daisyui-mcp
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

[](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](https://github.com/jlowin/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](https://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

```bash
git clone https://github.com/birdseyevue/fastmcp.git
cd fastmcp
```

### 2. Create a virtual environment (recommended)

```bash
python -m venv venv

# Windows
venv\Scripts\activate

# macOS/Linux
source venv/bin/activate
```

### 3. Install dependencies

```bash
pip install -r requirements.txt
```

---

## 🐳 Docker

You can also run the MCP server using Docker.

### Build and run with Docker

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

### Using Docker Compose

```bash
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

```json
{
  "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:

```bash
python update_components.py
```

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

### Running the server

```bash
python mcp_server.py
```

### Updating component docs

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

```bash
python update_components.py
```

---

## ⚙️ Configuration

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

📁 Generic Configuration

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

🪟 Windows Example

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

🍎 macOS/Linux Example

```json
{
  "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](https://github.com/birdseyevue)
- **Source:** [birdseyevue/daisyui-mcp](https://github.com/birdseyevue/daisyui-mcp)
- **License:** MIT

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

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-birdseyevue-daisyui-mcp
- Seller: https://agentstack.voostack.com/s/birdseyevue
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.