RemixIcon

Provides keyword-based access to Remix Icon metadata via a local MCP endpoint for fast icon selection.

typescript

72

GitHub Stars

typescript

Language

4 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "remix-design-remixicon-mcp": {
      "command": "npx",
      "args": [
        "remixicon-mcp"
      ]
    }
  }
}

RemixIcon MCP provides a focused, fast way to map concise icon-related keywords to Remix Icon metadata. You input up to 20 keywords, and you receive the top 5 matching icon names with rich metadata to help you decide quickly which icon to use.

How to use

You interact with RemixIcon MCP through a client that can communicate via MCP’s stdio interface. Provide a comma-separated list of up to 20 keywords. The server responds with exactly five icon candidates, ranked by relevance, along with their metadata and guidance to help you pick a single icon.

How to install

Prerequisites: you need Node.js installed on your system. Use a recent LTS version to ensure compatibility with the MCP runtime.

Install and run the MCP server as a CLI tool.

# Install as a CLI tool globally
npm install -g remixicon-mcp

# Or run directly with npx
npx remixicon-mcp

# For development
pnpm install
pnpm typecheck
pnpm test

Configuration and practical tips

You can use RemixIcon MCP as a local stdio service or integrate it with clients that support MCP. When running via npx, use the following invocation as the runtime command.

{
  "mcpServers": {
    "remixicon": {
      "command": "npx",
      "args": ["remixicon-mcp"]
    }
  }
}

Notes for platform integrations

CLI-ready behavior means you can drop RemixIcon MCP into automation or conversational integrations. It returns a ranked list of five candidates with detailed metadata and guidance that helps an LLM or automation choose exactly one icon.

Available tools

search_icons

Accepts a comma-separated string of up to 20 keywords and returns the top 5 matching Remix Icon entries with metadata.