DaisyUI MCP Server

Markdown 使用说明:

  • 项目简介 这是一个基于 FastMCP 的 MCP 服务器实现,核心功能是向 MCP 客户端暴露工具接口,允许通过对 DaisyUI 组件文档的索引进行查询与检索,帮助 LLM 应用实现对组件文档的动态获取与引用。

  • 主要功能点

    • 组件列表工具(list_components):返回可用 DaisyUI 组件及简要描述的清单,便于发现可用的组件。
    • 组件详情工具(get_component(name)):根据组件名称,返回该组件的完整 Markdown 文档(包含用法、CSS 类、示例等)。
    • 数据源与索引:组件文档放在本地的 components/ 目录,,通过 update_components.py 自动抓取并生成各组件的 Markdown 文档。
    • 服务器端基于 MCP 的 JSON-RPC 调用模型,支持通过工具名调用并返回文本结果,便于在对话中嵌入组件文档信息。
  • 安装步骤

    1. 安装 Python 3.9 及以上环境。
    2. 安装运行时依赖:pip install fastmcp
    3. 可选:执行 update_components.py 以从 DaisyUI 官方资源生成 components/ 目录中的 Markdown 文档(若尚无数据则需要先运行该步骤)。
    4. 启动服务器:在项目根目录执行 python mcp_server.py(确保当前目录包含 mcp_server.py、components/ 目录及相关依赖)。
  • 服务器配置(JSON,供 MCP 客户端准备连接) 该配置用于 MCP 客户端在建立连接时知道服务器的名称、启动方式与参数。示例如下,实际使用时请替换为与你的环境一致的路径与参数: { "server_name": "DaisyUI MCP Server", "command": "python", "args": ["mcp_server.py"], "working_directory": "<your_project_root>" } 注释说明:

    • server_name:服务器对外显示的名称,便于识别。
    • command:启动服务器所用的命令,此处为 Python 解释器。
    • args:启动命令的参数,此处为要执行的脚本文件名。
    • working_directory:服务器所在的工作目录,通常是项目根目录。
  • 基本使用方法

    • 启动并监听:根据上面的命令在服务器上启动后,服务器将通过 MCP 框架对外提供 list_components 与 get_component 两个工具。
    • 客户端交互方式:LLM 客户端通过 JSON-RPC 调用工具名,以获取组件列表或特定组件的详细文档文本。
    • 使用场景:在需要为对话生成提供 DaisyUI 组件使用文档、示例与参考信息时调用 get_component,或通过 list_components 浏览可用组件并选择目标文档。

服务器信息