lucide-icons-mcp

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

• Git
• Bun or Node.js

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

npx lucide-icons-mcp --stdio
# or if installed globally
lucide-icons-mcp --stdio

Local Development

There are two main ways to run the MCP server:

1. HTTP Mode

Suitable for clients that support communication over HTTP.

For development (using Bun):

bun run start
# or directly
bun run src/entry.ts

2. Stdio Mode

Often used for direct integration with tools like Claude Desktop or the MCP Inspector.

For development (using Bun):

bun run src/entry.ts --stdio

Configuration with AI Tools

Example: Claude Desktop

To use this MCP server in Claude Desktop:

1. Open your Claude Desktop configuration file:

code ~/Library/Application\ Support/Claude/claude_desktop_config.json

2. Add the server to the mcpServers section:

Option A: via npx (Recommended):

{
  "mcpServers": {
    "lucide-icons": {
      "command": "npx",
      "args": ["lucide-icons-mcp", "--stdio"]
    }
  }
}

Option B: Pointing directly to the build output:

{
  "mcpServers": {
    "lucide-icons": {
      "command": "node",
      "args": ["/ABSOLUTE/PATH/TO/lucide-icons-mcp/build/entry.js", "--stdio"]
    }
  }
}

3. Save the file

... View full README on GitHub