home / mcp / hugeicons mcp server

Hugeicons MCP Server

MCP server that provides tools and resources for integrating Hugeicons into various platforms. It implements a Model Context Protocol (MCP) server that helps AI assistants provide accurate guidance for using Hugeicons.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "hugeicons-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@hugeicons/mcp-server"
      ]
    }
  }
}

You deploy Hugeicons MCP Server to enable AI assistants to discover icons, fetch glyphs, and provide platform-specific integration guidance for Hugeicons. This server exposes tools to search and list icons, retrieve glyph data, and access platform docs and usage instructions, all through a consistent MCP interface.

How to use

You interact with the Hugeicons MCP Server through an MCP client to discover icons, fetch glyphs, and obtain platform-specific guidance. Use the available tools to list all icons, search icons by name or tags, retrieve platform usage instructions, and obtain glyphs across styles. You can also access platform installation guides and font-based HTML integration resources to implement Hugeicons in your target application.

How to install

Prerequisites: ensure you have Node.js installed on your machine. You will also need npm (comes with Node.js) or an environment that supports running MCP servers.

Option A: Install Hugeicons MCP Server for Claude Desktop automatically via Smithery.

npx -y @smithery/cli install @hugeicons/mcp-server --client claude

To use with Claude Desktop, add the following server config to Claude’s MCP settings.

{
  "mcpServers": {
    "hugeicons": {
      "command": "npx",
      "args": [
        "-y",
        "@hugeicons/mcp-server"
      ]
    }
  }
}

Option B: Quick start by running the server directly with npx.

npx @hugeicons/mcp-server

Development workflow (auto-rebuild) if you are actively developing the server: run the watch task.

npm run watch

If you need debugging tools, start the MCP Inspector to access debugging utilities from your browser.

npm run inspector

Additional setup notes

Configure your client or hosting environment to connect to the MCP server using the stdio command shown above or any remote setup you use. The server exposes a curated set of tools and resources to support icon discovery, glyph retrieval, and platform-specific guidance.

Available tools

list_icons

Retrieve a list of all available Hugeicons icons.

search_icons

Search for icons by name or tags to quickly find what you need.

get_platform_usage

Obtain platform-specific usage instructions for integrating Hugeicons.

get_icon_glyphs

Fetch all glyphs (unicode characters) for a specific icon across all available styles.

get_icon_glyph_by_style

Get the glyph for a specific icon with a particular style.