Icon Mcp
About
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.
Details
- Author
- agentic-ph
- Downloads
- 317
- Categories
- Other
Jump to
- 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
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Icon McpCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
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.
search_icons
Search for icons by name across all or specific libraries with fuzzy matching
get_icon
Get detailed information about a specific icon
list_libraries
Get a list of all available icon libraries
get_library_info
Get detailed information about a specific library
search_by_category
Find icons by category or tag with fuzzy matching
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"icon mcp": {
"icon-search": {
"command": "npx",
"args": [
"icon-mcp"
],
"env": {
"CACHE_TTL": "300000",
"DEFAULT_SEARCH_LIMIT": "50",
"LOG_LEVEL": "info"
}
}
}
}
}McpServers
{
"icon-search": {
"command": "npx",
"args": [
"icon-mcp"
],
"env": {
"CACHE_TTL": "300000",
"DEFAULT_SEARCH_LIMIT": "50",
"LOG_LEVEL": "info"
}
}
}Icon MCP Server
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.
🚀 Features
- Multi-Library Support: Search across multiple icon libraries simultaneously
- Fuzzy Search: Advanced search with typo tolerance using Fuse.js
- Intelligent Caching: Fast response times with smart caching strategies
- Comprehensive Filtering: Filter by library, style, category, tags, and more
- NPM Package Integration: Automatic icon library management via NPM packages
- TypeScript: Full type safety and excellent developer experience
- MCP Protocol: Standard Model Context Protocol for seamless integration
📦 Supported Icon Libraries
- Bootstrap Icons - Official open source SVG icon library for Bootstrap
- Feather - Beautiful open source icons
- Octicons - GitHub's icon library
- Tabler Icons - Free and open source icons
🛠️ Installation
NPM Package
npm install -g icon-mcp
From Source
git clone https://github.com/your-org/icon-mcp.git
cd icon-mcp
npm install
npm run build
Build Icon Index
```bash
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
