
icon-mcp
io.github.pratham-jain33/icon-mcp
Lucide icon sets for AI: search 2000+ icons, style them, batch-export SVG. Offline, no key.
Documentation
icon-mcp
Offline MCP server providing searchable, parametric Lucide icons for AI assistants
MCP server providing searchable, parametric Lucide icon sets for AI assistants.
Motivation
AI assistants often fall back to emojis when a UI needs an icon, and creating a consistent set of icons requires design effort. This server lets assistants search a bundled Lucide collection, restyle icons, and export them offline, removing the need for external APIs or design work.
Tech stack
- Python ≥3.10
- fastmcp (>=2.0)
- Bundled Lucide SVG icons (≈2000)
Features
- Keyword search across 2000+ Lucide icons
- Parametric styling of stroke width, color, and size
- Batch generation of matching icon sets in a single call
- Fully offline operation, no API keys or network access
- Simple MCP command exposing
search_iconsandgenerate_iconstools
Installation
pip install icon-mcp
or with uvx:
uvx icon-mcp
From source:
git clone https://github.com/pratham-jain33/icon-mcp
cd icon-mcp
python -m venv .venv
.venv/bin/pip install -e .
Usage
Start the MCP server:
icon-mcp
The server registers two tools:
search_icons– find icon names by keyword.generate_icons– render one or many icons with sharedstroke_width,color, andsize.
Example Claude Desktop configuration (JSON):
{
"mcpServers": {
"icon-mcp": {
"command": "uvx",
"args": ["icon-mcp"]
}
}
}
After restarting the assistant, you can ask for icons, e.g.,
"Find me a settings icon and a trash icon, both 1.5px stroke in #2f6bff at 32px, as SVGs." The assistant will call
search_iconsorgenerate_iconsand receive styled SVG markup.
After restarting the assistant, you can request icons such as:
Find me a settings icon and a trash icon, both 1.5px stroke in #2f6bff at 32px, as SVGs.
The assistant will call generate_icons and receive a JSON response containing the styled SVG markup for each icon.
Created with repo-doctor
icon-mcppip install icon-mcp