lucide-icons-mcp

What is lucide-icons-mcp?

lucide-icons-mcp is a Model Context Protocol (MCP) server that exposes Lucide React icons as resources and tools for LLMs and agentic applications. It enables AI coding assistants to search, browse, and retrieve usage information for over 1,500+ Lucide icons.

How to use lucide-icons-mcp?

Install globally via npm or use npx to run the server. Run in HTTP mode (default port 3000) with npx lucide-icons-mcp or in stdio mode with npx lucide-icons-mcp --stdio. Configure it in Claude Desktop by adding a mcpServers entry pointing to the command.

Key features of lucide-icons-mcp

• Search through 1,500+ Lucide icons by name or category
• Browse icons organized by categories (Design, Communication, etc.)
• Get React/JSX code examples for any icon
• Detailed information for each icon (name, category, etc.)
• Supports both HTTP server and stdio-based MCP modes
• Ready for Claude Desktop and other MCP clients

Use cases of lucide-icons-mcp

• AI coding assistant finding icons by name for a UI component
• Developer browsing category‑organized icons to pick the right one
• Getting React/JSX import and usage examples for a specific icon
• Listing all available icons filtered by category
• Understanding available icon categories with their icon counts

FAQ from lucide-icons-mcp

What does lucide-icons-mcp expose to AI tools?

It exposes MCP tools: search_icons, search_categories, get_icon_usage_examples, list_icons_by_category, list_all_categories, get_icon_info, and list_all_icons.

What are the prerequisites to run it?

You need Git, and either Bun or Node.js installed. The project uses Bun for development but can run via npx or global npm install.

Can I use lucide-icons-mcp with Claude Desktop?

Yes. Add a configuration entry in your Claude Desktop config file (e.g., claude_desktop_config.json) using npx or pointing to the build output.

Does lucide-icons-mcp run in both HTTP and stdio modes?

Yes. Use --stdio flag for stdio mode; without it the server runs in HTTP mode (defaults to port 3000).

How are icon data kept up to date?

The project includes a web crawler that automatically extracts icon information from the Lucide website, ensuring current data and categories.