在构建基于 DSH 的智能体或工具时,获取高质量的矢量图标是常见需求。传统的做法可能需要手动下载 SVG 或通过外部服务查询。xby-iconify-icon 是一个 MCP 服务器插件,它通过封装 Iconify API,为开发者提供了一套标准化的接口来浏览、搜索和获取图标数据及代码片段。
这是一个由 xby_skill 维护的插件,旨在解决智能体开发中获取图标资源的痛点。它作为一个中间层,允许通过 DSH 的命令直接访问 Iconify 平台上超过 20 万的开源矢量图标。
核心功能¶
插件提供了以下核心能力:
- set_xby_apikey:在聊天中设置 API 密钥。该密钥会自动持久化,重启进程后依然有效。
- get_all_icon_sets:浏览所有可用的图标集(200+ 图标集,20万+ 图标)。返回包含名称、图标总数、作者、许可证和示例图标的列表。
- get_icon_set:获取特定图标集的详细信息,提供图标集前缀(例如 ‘mdi’, ‘fa’, ‘bi’)。
- search_icons:通过灵活的查询参数搜索图标,支持在所有图标集或特定集合中查找。
- get_icon_data:获取特定图标数据及流行框架(React, Vue, Svelte 等)的使用示例。需要提供完整的图标名称,格式为 ‘prefix:icon-name’(例如 ‘mdi:home’, ‘fa:user’)。
安装与启用¶
推荐从 GitHub 直接安装。命令如下:
# 格式: dsh plugin --profile <profile> add github:<owner>/<repo>
dsh plugin --profile web add github:xby_skill/xby-iconify-icon
配置¶
使用插件前需要先获取 API 密钥。请前往 小笨羊官网 注册并获取密钥。
注意事项¶
- 方式二和方式三仅用于本地开发调试,不作为生产环境的标准安装方式。
- 获取 API 密钥需前往小笨羊官网注册。
- 该插件以当前 dsh 进程的权限运行,安装前请检查源码与许可证。
总结¶
xby-iconify-icon 通过提供标准化的 MCP 接口,简化了 Iconify 图标的使用流程。开发者无需手动处理图标格式或搜索逻辑,即可直接在对话中获取图标数据及代码片段。