Livewire磁通MCP
](https://www.npmjs.com/package/livewire-flux-mcp)   ](https://www.npmjs.com/package/livewire-flux-mcp) 
MCP（模型上下文协议）服务器，提供对Livewire Flux组件和布局的访问 Livewire通量该服务器允许AI助手根据需要获取和搜索Flux组件和布局文档。
⚠️ 免责声明 这是一个个人项目，与Livewire Flux无关。
支持我
嘿，伙计们，
你喜欢这个包裹吗？你觉得它有用吗，它很适合你的项目？
我很乐意帮助你，如果你考虑支持我的工作，我将不胜感激。
你甚至可以选择😃:
- 你可以 赞助我😎
- 你可以 给我买杯咖啡☕ 或者披萨🍕
- 你可以“明星⭐“这个仓库（顺便说一句，它是免费的😉)
它做什么
此MCP服务器抓取并提供对Livewire Flux文档的结构化访问，使AI助手能够：
- 从以下位置获取特定Flux组件的文档
https://fluxui.dev/components/ - 从以下位置获取特定Flux布局的文档
https://fluxui.dev/layouts/ - 访问具有API详细信息、道具和使用模式的组件和布局参考部分
- 搜索组件和布局文档内容
- 列出所有可用的Flux组件
- 浏览并搜索所有可用的Heroicons，以便与flux：icon组件一起使用
- 直接从Flux官方网站访问最新文档
- 高性能缓存 24小时有效期，实现最佳响应时间
可用的MCP工具
服务器提供四种MCP工具：
fetch_flux_docs-获取组件或布局的文档
- component （可选）：用于获取文档的特定组件名称 - layout （可选）：用于获取文档的特定布局名称（例如，“页眉”、“侧边栏”） - search （可选）：用于筛选内容的搜索词 - 在可用时自动包含参考部分 - 胎儿来自 https://fluxui.dev/components/{component} 或 https://fluxui.dev/layouts/{layout}
list_flux_components-列出所有可用的Flux组件
- 无需参数 - 返回组件 https://fluxui.dev/components/ 前缀 - 提供组件名称及其文档路径
list_flux_layouts-列出所有可用的Flux布局
- 无需参数 - 返回布局 https://fluxui.dev/layouts/ 前缀 - 提供布局名称及其文档路径
list_flux_component_icons-列出通量：图标组件的所有可用Heroicons
- variant （可选）：按图标变体过滤(outline, solid, mini, micro) - search （可选）：用于过滤图标名称的搜索词 - 从Heroicons GitHub存储库获取实际图标名称 - 为每个变体提供使用示例、维度和GitHub链接 - 使用正确的Flux语法返回所有可用图标的完整列表
示例用法
一旦MCP服务器运行，AI助手就可以使用它来：
- 获取特定组件的文档：“显示按钮组件文档”
- 获取特定布局的文档：“显示标题布局文档”
- 搜索内容：“查找与表单相关的所有组件”
- 列出可用组件：“有哪些Flux组件可用？”
- 列出可用的布局：“有哪些Flux布局可用？”
- 浏览所有可用图标：“显示所有可用于flux的Heroicons:icon”
- 搜索特定图标：“查找轮廓变体中的所有箭头图标”
- 获取图标使用示例：“如何在实体变体中使用用户图标？”
服务器会自动从GitHub的fluxui.dev/components、fluxui.ev/layouts和Heroicons中获取最新文档，以结构化格式呈现所有内容，便于人工智能助手使用。获取组件或布局文档时，它包括主要内容和具有详细API信息的参考部分。
手动注册MCP服务器
有时，您可能需要向您选择的编辑器手动注册Livewire Flux MCP服务器。 您应该使用以下详细信息注册MCP服务器：
Commandnpx Argslivewire-flux-mcp
{
"mcpServers": {
"flux-docs": {
"command": "npx",
"args": ["livewire-flux-mcp"]
}
}
}性能和缓存
MCP服务器包括智能缓存，以提供最佳性能：
- 24小时缓存过期 -内容缓存1天，以平衡新鲜度和性能
- 自动缓存管理 -过期的条目会自动清理
- 智能缓存密钥 -不同参数（组件、布局、搜索、变体）的不同缓存条目
- GitHub API速率限制保护 -防止在获取海洛因时达到GitHub API限制
- 即时响应 -缓存请求以毫秒而不是秒为单位返回
缓存行为
- 文件要求：按组件/布局和搜索词组合缓存
- 组件列表：全局缓存（每天刷新）
- 布局列表：全局缓存（每天刷新）
- 图标列表：按变量和搜索组合缓存
- 高速缓冲存储器：内存中（服务器重新启动时重置）
缓存系统对 list_flux_component_icons 该工具，每个请求最多可以进行4次GitHub API调用，无需缓存。
更新日志
请看 更新日志 有关最近发生的变化的更多信息。
贡献
请看 贡献 了解详情。
安全漏洞
请审阅 我们的安全政策 关于如何报告安全漏洞。
鸣谢
许可证
MIT许可证（MIT）。请看 许可证文件 了解更多信息。