Hugeicons MCP Server

🚀 Hugeicons MCP Server

This is an MCP server for Hugeicons integration and documentation. It is a TypeScript-based MCP server that provides tools and resources to assist in integrating Hugeicons across various platforms. It implements the Model Context Protocol (MCP) server, enabling AI assistants to offer accurate guidance on using Hugeicons.

🚀 Quick Start

You can also directly run the server using npx:

npx @hugeicons/mcp-server

✨ Features

Tools

• list_icons - Retrieve a list of all available Hugeicons.
• search_icons - Search for icons by name or tag.
• get_platform_usage - Get instructions on using Hugeicons on a specific platform.

Resources

Platform documentation (available in Markdown format):

• hugeicons://docs/platforms/react - React integration guide.
• hugeicons://docs/platforms/vue - Vue integration guide.
• hugeicons://docs/platforms/angular - Angular integration guide.
• hugeicons://docs/platforms/svelte - Svelte integration guide.
• hugeicons://docs/platforms/react-native - React Native integration guide.
• hugeicons://docs/platforms/flutter - Flutter integration guide.

Icon data:

• hugeicons://icons/index - Complete index of all Hugeicons (in JSON format).

Capabilities

This server offers comprehensive support for Hugeicons integration, including:

• Icon discovery and search.
• Platform-specific installation guides.
• Usage example code snippets.
• Component property documentation.
• Package installation instructions.

📦 Installation

To use with Claude Desktop, add the server configuration:

On MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json On Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "hugeicons": {
      "command": "npx",
      "args": [
        "-y",
        "@hugeicons/mcp-server"
      ]
    }
  }
}

The args array specifies:

1. -y: Automatically answer "yes" to resolve npx prompts.
2. Package name: @hugeicons/mcp-server.

🔧 Development

Install dependencies

npm install

Build the server

npm run build

Development with automatic rebuild

npm run watch

Debugging

Since the MCP server communicates via stdio, debugging can be challenging. We recommend using MCP Inspector, which is available as a package script:

npm run inspector

The Inspector will provide a URL for you to access the debugging tools in your browser.