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.
Explore
- 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
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
The server can be configured via environment variables:
CACHE_TTL=300000 # Cache TTL in milliseconds (default: 5 minutes)
CACHE_MAX_SIZE=1000 # Maximum cache entries (default: 1000)
DEFAULT_SEARCH_LIMIT=50 # Default search result limit
FUZZY_THRESHOLD=0.3 # Default fuzzy search threshold
For development with a local build:
{
"mcpServers": {
"icon-search-dev": {
"command": "node",
"args": ["dist/index.js"],
"cwd": "/path/to/icon-mcp",
"env": {
"NODE_ENV": "development",
"LOG_LEVEL": "debug",
"CACHE_TTL": "60000"
}
}
}
}
Using the Docker image:
{
"mcpServers": {
"icon-search-docker": {
"command": "docker",
"args": [
"run",
"--rm",
"-i",
"--env",
"CACHE_TTL=300000",
"--env",
"LOG_LEVEL=info",
"icon-mcp:latest"
]
}
}
}
Configure the server behavior through environment variables:
| Variable | Description | Default | Example |
| ---------------------- | ---------------------------------------- | ------------ | ------------- |
| CACHE_TTL | Cache time-to-live in milliseconds | 300000 | 600000 |
| CACHE_MAX_SIZE | Maximum number of cached entries | 1000 | 2000 |
| DEFAULT_SEARCH_LIMIT | Default number of search results | 50 | 100 |
| FUZZY_THRESHOLD | Default fuzzy search threshold (0.0-1.0) | 0.3 | 0.5 |
| LOG_LEVEL | Logging verbosity | info | debug |
| NODE_ENV | Environment mode | production | development |
npm list -g icon-mcp
npm install -g icon-mcp
Permission Errors
npm install
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"
}
}
}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.
