Icon Mcp

Name: Icon Mcp
Author: agentic-ph

@agentic-ph

About Icon Mcp

A powerful Model Context Protocol (MCP) server that provides unified search capabilities across multiple icon libraries with fuzzy search, intelligent caching, and comprehensive filtering options.

#icon #icons

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "icon-search": {
      "command": "npx",
      "args": [
        "icon-mcp"
      ],
      "env": {
        "CACHE_TTL": "300000",
        "DEFAULT_SEARCH_LIMIT": "50",
        "LOG_LEVEL": "info"
      }
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Icon Mcp?

Icon Mcp is a Model Context Protocol (MCP) server that provides unified search across multiple icon libraries with fuzzy search, intelligent caching, and comprehensive filtering options. It is designed for developers integrating icon search into MCP‑compatible clients like Claude Desktop and VS Code.

How to use Icon Mcp?

Install globally via npm install -g icon-mcp, build the icon index with npm run build-icons, then start the server with npm start. Configure the server in your MCP client’s JSON (e.g., claude_desktop_config.json) by setting the command to npx icon-mcp and optionally customizing environment variables like CACHE_TTL or FUZZY_THRESHOLD.

Key features of Icon Mcp

Multi‑library search across Bootstrap Icons, Feather, Octicons, and Tabler Icons
Fuzzy search with typo tolerance using Fuse.js
Intelligent caching with configurable TTL and LRU eviction
Filtering by library, style, category, and tags
NPM package integration for automatic icon library management
Full TypeScript type safety and excellent developer experience

Use cases of Icon Mcp

Quickly find icons by name across multiple libraries during UI development
Integrate icon search into AI‑powered code assistants or chat tools
Build custom icon pickers with fuzzy matching and category filtering
Automate icon discovery for design‑to‑code workflows

FAQ from Icon Mcp

Which icon libraries are supported?

Bootstrap Icons, Feather, Octicons, and Tabler Icons are supported out of the box. Additional libraries can be added via the provider system.

How do I add a custom icon library?

Add the library as an NPM dependency, create a provider class extending BaseNpmProvider, register it in the provider index, and rebuild the icon index with npm run build-icons.

How can I configure caching behavior?

Set the CACHE_TTL (default 300 000 ms) and CACHE_MAX_SIZE (default 1000) environment variables in your MCP client configuration.

What MCP tools are available?

The server exposes search_icons, get_icon, list_libraries, get_library_info, and search_by_category tools. search_icons supports parameters like query, libraries, fuzzy, limit, and threshold.

How do I verify the connection is working?

After configuration, check that the server appears in your client’s server list, test the list_libraries tool, and look for connection messages in the logs.