Lucide Icons MCP

v0.1.57Developer Toolsstable

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.

lucidelucide-iconslucide-reactmcptypescript
Share:
35
Stars
0
Downloads
0
Weekly
0/5

What is Lucide Icons MCP?

Lucide Icons MCP is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to 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.

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.

This server falls under the Developer Tools and APIs categories on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • A Model Context Protocol (MCP) server exposing Lucide icons

Use Cases

Access Lucide icons as resources for AI-generated designs.
Search and retrieve icons by name or category.
Integrate consistent iconography into applications.
SeeYangZhi

Maintainer

LicenseMIT License
Languagetypescript
Versionv0.1.57
UpdatedMay 20, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

NPM

npx -y lucide-icons-mcp

Manual Installation

npx -y lucide-icons-mcp

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use Lucide Icons MCP

lucide-icons-mcp is a Model Context Protocol server that exposes the entire Lucide icon library — over 1,500 carefully crafted, consistently styled SVG icons — as searchable resources and tools for AI assistants. It lets LLMs and agentic applications search icons by name or category, retrieve ready-to-use React/JSX code snippets, and browse icon metadata, making it ideal for AI-assisted UI development where the assistant needs to recommend or insert the right icon automatically.

Prerequisites

  • Node.js 18 or later (or Bun runtime for development builds)
  • An MCP-compatible client such as Claude Desktop, Cursor, or Cline
  • No API key required — the icon data is bundled with the package
1

Run directly with npx (stdio mode)

The easiest way to use the server is to run it directly via npx in stdio mode, which is the standard transport for Claude Desktop and most MCP clients.

npx -y lucide-icons-mcp --stdio
2

Add to your MCP client configuration

Add the server entry to your claude_desktop_config.json (on macOS at ~/Library/Application Support/Claude/claude_desktop_config.json) using the stdio transport.

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

Restart your MCP client

Restart Claude Desktop (or your chosen MCP client) so it picks up the new server configuration and connects to the Lucide icons server.

4

Verify the connection

Ask your AI assistant to list available Lucide icon categories or search for a specific icon to confirm the server is working correctly.

5

(Optional) Run the HTTP server for browser-based clients

If your client connects over HTTP rather than stdio, start the server in HTTP mode. It defaults to port 3000.

npx lucide-icons-mcp

Lucide Icons MCP Examples

Client configuration (Claude Desktop stdio)

Complete claude_desktop_config.json snippet to connect Claude Desktop to the Lucide icons MCP server using stdio transport.

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

Prompts to try

Example prompts to use with your AI assistant once the Lucide icons server is connected.

- "What Lucide icons are available in the 'Communication' category?"
- "Give me the JSX import and usage for the Lucide Mail icon."
- "I need an icon for a shopping cart — which Lucide icons would work best?"
- "Show me all Lucide icons related to security or authentication."

Troubleshooting Lucide Icons MCP

npx command hangs or fails to download the package

Ensure you have Node.js 18 or later installed (`node --version`) and a working internet connection. Try clearing the npx cache with `npx clear-npx-cache` and running again.

MCP client shows 'server disconnected' immediately after startup

Make sure you include the `--stdio` flag in the args array. Without it, the server starts in HTTP mode and will not respond to the stdio transport expected by Claude Desktop and most clients.

Frequently Asked Questions about Lucide Icons MCP

What is Lucide Icons MCP?

Lucide Icons MCP is a Model Context Protocol (MCP) server that 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. It connects AI assistants to external tools and data sources through a standardized interface.

How do I install Lucide Icons MCP?

Install via npm with the command: npx -y lucide-icons-mcp. Then add the server configuration to your AI client's JSON config file (e.g., claude_desktop_config.json or .cursor/mcp.json).

Which AI clients work with Lucide Icons MCP?

Lucide Icons MCP works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is Lucide Icons MCP free to use?

Yes, Lucide Icons MCP is open source and available under the MIT License license. You can use it freely in both personal and commercial projects.

Browse More Developer Tools MCP Servers

Explore all developer tools servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

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

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use Lucide Icons MCP?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides