DaisyUI组件文档服务器

一个基于MCP协议的本地服务器,提供DaisyUI组件文档的高效访问和自定义功能,适用于AI助手和前端开发。

  • by birdseyevue
  • Python
  • 本地部署
  • 78 星标
  • 更新于
在 GitHub 查看 birdseyevue/daisyui-mcp

使用说明

🌼 DaisyUI MCP服务器

DaisyUI组件文档的令牌友好型本地MCP服务器

让你的AI助手能够使用DaisyUI构建漂亮的UI 🚀

特性 • 安装 • 码头工人 • 用法 • 配置


🌼 小心

这个回购是一个有趣的小项目,看到它达到70多颗星和15多个分叉,真的很酷,谢谢!但我想让所有新来的人知道,DaisyUI终于在 daisyui.com/docs/skill/。我现在建议使用这个,因为它是官方的,老实说,对现代人工智能模型来说更好。如果你已经在使用这个仓库,它仍然可以工作,但对于新项目,我会使用官方技能。我至少建议你去看看,看看它是否更符合你的需求。再次感谢您的支持,编码愉快! 🌼


✨ 特性

  • 🎯 代币高效 --仅通过MCP工具公开相关上下文,节省宝贵的令牌
  • 📚 60+组件 --全面覆盖DaisyUI的组件库
  • 🔄 可自动更新 --只需一个命令,即可随时获取最新文档
  • ✏️ 可定制的 --编辑或添加您自己的组件文档以适应您的项目
  • ⚡ 快速轻便 --内置于 FastMCP 为了获得最佳性能

🛠️ MCP工具

此服务器公开了AI助手可以使用的两个工具:

工具 说明
list_components 📋 列出所有可用的DaisyUI组件及其简短描述
get_component 📖 获取特定组件的完整文档(类、语法、示例)

💡 组件文档从以下位置提取 daisyui.com/llms.txt 并作为markdown文件存储在本地。通过这种方式,您还可以添加自己的自定义组件或根据自己的喜好或项目需求编辑现有组件。


💬 示例提示

试着问你的人工智能助手:

"What DaisyUI components are available?"
"Implement a responsive card grid using DaisyUI"
"How does the modal component work? Show me an example"

📦 安装

1.克隆存储库

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

2.创建虚拟环境(推荐)

python -m venv venv

# Windows
venv\Scripts\activate

# macOS/Linux
source venv/bin/activate

3.安装依赖项

pip install -r requirements.txt

🐳 码头工人

您还可以使用Docker运行MCP服务器。

使用Docker构建和运行

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

使用Docker Compose

docker compose up --build

这 docker-compose.yml 挂载本地 components/ 目录作为一个卷,因此您对主机上的组件文档所做的任何更改都会反映在容器内。

针对AI助手的Docker配置

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

🚀 用法

首次设置

首次运行时,MCP服务器将没有任何组件文档。通过运行获取它们:

python update_components.py

这将获取最新 llms.txt 从DaisyUI生成所有markdown文件 /components.

运行服务器

python mcp_server.py

更新组件文档

如果DaisyUI发布新组件或更新其文档,只需运行:

python update_components.py

⚙️ 配置

将MCP服务器添加到AI助手的配置中:

📁 Generic Configuration
{
  "servers": {
    "daisyui": {
      "command": "<path-to-repo>/venv/Scripts/python.exe",
      "args": ["<path-to-repo>/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"]
    }
  }
}

📁 项目结构

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)

🤝 贡献

欢迎投稿!请随意:

  • 🐛 报告错误
  • 💡 建议新功能
  • 📝 改进文档
  • 🔧 提交拉取请求

📄 许可证

该项目根据 MIT 许可证 --看看 许可证 文件以获取详细信息。

免费使用、修改和分发!玩得开心 🎉


制作于❤️ DaisyUI社区

⭐ 如果你觉得这个仓库有用,就把它标上!