Lucide Icons MCP
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.
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
Maintainer
Works with
Installation
NPM
npx -y lucide-icons-mcpManual Installation
npx -y lucide-icons-mcpConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
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
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 --stdioAdd 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"]
}
}
}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.
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.
(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-mcpLucide 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.
Lucide Icons MCP Alternatives — Similar Developer Tools Servers
Looking for alternatives to Lucide Icons MCP? Here are other popular developer tools servers you can use with Claude, Cursor, and VS Code.
Ecc
★ 188.2kThe agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.
Javaguide
★ 155.8kJava 面试 & 后端通用面试指南,覆盖计算机基础、数据库、分布式、高并发、系统设计与 AI 应用开发
Gemini CLI
★ 104.5kA secure MCP server that wraps the Google Gemini CLI, allowing clients to query Gemini models using local OAuth sessions without requiring an API key. It provides tools for model interaction and diagnostics with built-in protection against command in
Awesome MCP Servers
★ 87.3k⭐ Curated list of Model Context Protocol (MCP) servers - tools that extend Claude Desktop, Cursor, Windsurf, and other MCP clients with custom capabilities.
MCP Servers
★ 86.0kModel Context Protocol Servers
CC Switch
★ 77.5kA cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Gemini CLI & Hermes Agent. Only official website: ccswitch.io
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.
Set Up Lucide Icons MCP in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
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.