在構建基於 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 圖標的使用流程。開發者無需手動處理圖標格式或搜索邏輯,即可直接在對話中獲取圖標數據及代碼片段。