SeeYangZhi/heroicons-mcp
If you are the rightful owner of heroicons-mcp and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.
A Model Context Protocol (MCP) server exposing Heroicons as resources and tools for LLMs and agentic applications.
The Heroicons MCP server is a specialized server built using the Model Context Protocol (MCP) to provide access to the Heroicons library. Heroicons is a collection of hand-crafted SVG icons designed by the creators of Tailwind CSS, available in multiple styles such as Outline and Solid. This server allows AI coding assistants and other agentic applications to access and utilize these icons effectively. By exposing Heroicons as MCP resources, the server enhances the capabilities of AI tools, enabling them to search for icons by name or keywords, list all available icons, and provide usage examples in JSX format. The server is built with Bun and the MCP TypeScript SDK, offering flexibility to run as either an HTTP server or a stdio-based MCP server. This makes it suitable for integration with various platforms, including Claude Desktop and other MCP clients.
Features
- Exposes Heroicons as MCP resources in Outline and Solid styles.
- Provides tools for searching icons by name or keywords.
- Allows listing all icons or icons within a specific style.
- Ready for integration with Claude Desktop and other MCP clients.
- Can be run as an HTTP server or a stdio-based MCP server.
Usages
npx with Claude Desktop
{
"mcpServers": {
"heroicons": {
"command": "npx",
"args": ["heroicons-mcp", "--stdio"]
}
}
}node with Claude Desktop
{
"mcpServers": {
"heroicons": {
"command": "node",
"args": ["/ABSOLUTE/PATH/TO/heroicons-mcp/build/entry.js", "--stdio"]
}
}
}Tools
list_all_icons
Lists all available Heroicons, optionally filtered by style (outline, solid).
search_icons
Searches for Heroicons by name or keywords across all styles.
get_icon_usage_examples
Retrieves JSX example usage for a specific icon.