Lucide Icons
About
A Model Context Protocol (MCP) server exposing Lucide icons as resources and tools for LLMs and agentic applications. Built with Bun and the MCP TypeScript SDK.
Details
- License
- View license
Explore
- 🔍 Icon Search: Search through 1,500+ Lucide icons by name or category
- 📂 Category Browsing: List icons by categories (Design, Communication, Media, etc.)
- 💡 Usage Examples: Get React/JSX code examples for any icon
- 🔧 Icon Information: Detailed information about each icon
- 🚀 MCP Integration: Ready for Claude Desktop and other MCP clients
- 🌐 Dual Mode: HTTP server or stdio-based MCP server
- 📊 Comprehensive Coverage: All Lucide icons with proper JSX usage
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
Lucide IconsCommand (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
Refer to the official Bun installation guide.
After installation, restart your terminal and check:
bun --version
bun install
lucide-icons-mcp --stdio
- Description: Get React/JSX usage examples for a specific Lucide icon
- Parameters:
- name (string): Icon name (e.g., 'Home', 'User', 'Settings')
Here's how an AI tool might use this MCP server:
User: "Show me how to use the ArrowRight icon"
AI tool calls get_icon_usage_examples:
{
"name": "ArrowRight"
}
Response:
import { ArrowRight } from "lucide-react";
function Example() {
return (
<div>
<ArrowRight />
</div>
);
}
```
This MCP server exposes the following tools to AI coding assistants:
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"lucide icons": {
"lucide-icons-mcp": {
"command": "bun",
"args": [
"run",
"build"
]
}
}
}
}McpServers
{
"lucide-icons-mcp": {
"command": "bun",
"args": [
"run",
"build"
]
}
}A Model Context Protocol (MCP) server exposing Lucide React icons as resources and tools for LLMs and agentic applications. Built with Bun and the MCP TypeScript SDK.
What is Lucide?
Lucide is a beautiful & consistent icon toolkit made by the community. It's an open-source icon library that provides over 1,500+ carefully crafted icons in a single, consistent style. Originally forked from Feather Icons, Lucide has grown into one of the most popular icon libraries for modern web development.
What is MCP?
The Model Context Protocol (MCP) is a standard for AI tools to request specific context from sources outside their main training data.
This MCP server allows AI coding assistants and other agentic applications to access information about Lucide React icons, enabling better assistance with icon search, discovery, and implementation.
Features
- 🔍 Icon Search: Search through 1,500+ Lucide icons by name or category
- 📂 Category Browsing: List icons by categories (Design, Communication, Media, etc.)
- 💡 Usage Examples: Get React/JSX code examples for any icon
- 🔧 Icon Information: Detailed information about each icon
- 🚀 MCP Integration: Ready for Claude Desktop and other MCP clients
- 🌐 Dual Mode: HTTP server or stdio-based MCP server
- 📊 Comprehensive Coverage: All Lucide icons with proper JSX usage
Prerequisites
Getting Started (Development)
1. Clone the repository
git clone https://github.com/SeeYangZhi/lucide-icons-mcp.git
cd lucide-icons-mcp
2. Install Bun (if you don't have it)
Refer to the official Bun installation guide.
After installation, restart your terminal and check:
bun --version
3. Install dependencies
bun install
4. Build the project
This compiles the TypeScript source to JavaScript in the build directory.
bun run build
Usage
HTTP Mode
You can run the HTTP server using npx:
npx lucide-icons-mcp
This starts the HTTP server (defaults to port 3000).
Or install globally:
npm install -g lucide-icons-mcp
Then run:
lucide-icons-mcp
Stdio Mode
```bash
npx lucide-icons-mcp --stdio
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
