When building DSH-based agents or tools, obtaining high-quality vector icons is a common requirement. Traditional approaches may require manually downloading SVGs or querying external services. xby-iconify-icon is an MCP server plugin that wraps the Iconify API and provides developers with a standardized set of interfaces for browsing, searching, and retrieving icon data and code snippets.

This is a plugin maintained by xby_skill, aimed at addressing the pain point of acquiring icon resources in agent development. It acts as an intermediary layer, allowing direct access to more than 200,000 open-source vector icons on the Iconify platform through DSH commands.

Core Features

The plugin provides the following core capabilities:

  • set_xby_apikey: Set the API key in chat. The key is automatically persisted and remains valid after restarting the process.
  • get_all_icon_sets: Browse all available icon sets (200+ icon sets, 200,000+ icons). Returns a list including names, total icon counts, authors, licenses, and sample icons.
  • get_icon_set: Get detailed information about a specific icon set, including the icon set prefix (e.g., ‘mdi’, ‘fa’, ‘bi’).
  • search_icons: Search icons using flexible query parameters, supporting searches across all icon sets or within a specific set.
  • get_icon_data: Get specific icon data and usage examples for popular frameworks (React, Vue, Svelte, etc.). Requires the full icon name in the format ‘prefix:icon-name’ (e.g., ‘mdi:home’, ‘fa:user’).

Installation and Activation

It is recommended to install directly from GitHub. The command is as follows:

# 格式: dsh plugin --profile <profile> add github:<owner>/<repo>
dsh plugin --profile web add github:xby_skill/xby-iconify-icon

Configuration

Before using the plugin, you must first obtain an API key. Please visit Xiaobenyang Official Website to register and get the key.

Important Notes

  • Methods 2 and 3 are intended only for local development and debugging and are not standard installation methods for production environments.
  • To obtain the API key, register on the Xiaobenyang official website.
  • This plugin runs with the permissions of the current dsh process. Review the source code and license before installation.

Summary

xby-iconify-icon simplifies the process of using Iconify icons by providing standardized MCP interfaces. Developers can retrieve icon data and code snippets directly in conversation without manually handling icon formats or search logic.

For more information, see the GitHub repository or the plugin directory.