React Icons

•
1
•

Enables AI coding assistants to access and understand the React Icons library.

React Icons is a Model Context Protocol (MCP) server that facilitates the integration of React Icons with AI coding tools like Cursor, Windsurf, and Cline. By providing AI-powered coding assistants with access to information about the React Icons library, this server allows for enhanced coding assistance, including suggesting icons, providing usage examples, and improving overall developer workflow within React applications.

主な機能

01Enables searching for icons by name across all libraries or within a specific library.
02Provides information about all icon libraries available in react-icons.
03Retrieves all icons from a specific library.
04Provides detailed information about specific icons.
05Offers usage examples for icons in different React contexts.
060 GitHub stars

ユースケース

01Allow AI coding tools to suggest relevant icons based on user input.
02Help developers quickly find and integrate icons into their projects.
03Provide code snippets for using React Icons in React applications.

React Icons MCP Server

A Model Context Protocol (MCP) server for React Icons integration. This server enables AI coding tools like Cursor, Windsurf, Cline, and other AI-powered coding assistants to access and understand the React Icons library.

What is React Icons?

React Icons is a popular library that includes icons from multiple icon sets like Font Awesome, Material Design, Bootstrap, and many more. It allows easy integration of icons into React applications using ES6 imports.

What is MCP?

The Model Context Protocol is a standard for AI tools to request specific context from sources outside their main training data. This MCP server allows AI coding assistants to access information about React Icons to provide better coding assistance.

Features

  • Get information about all icon libraries available in react-icons
  • Search for icons by name across all libraries or within a specific library
  • Retrieve all icons from a specific library
  • Get detailed information about specific icons
  • Get usage examples for icons in different React contexts

Getting Started

Installation

npm install -g react-icons-mcp
# or
npx react-icons-mcp

Configuration

To use this MCP server with your AI coding tools, you'll need to add it to your tool's MCP configuration. Here are examples for popular AI coding assistants:

MacOS / Linux

{
  "mcpServers": {
    "React Icons MCP": {
      "command": "npx",
      "args": ["-y", "react-icons-mcp", "--stdio"]
    }
  }
}

Windows

{
  "mcpServers": {
    "React Icons MCP": {
      "command": "cmd",
      "args": ["/c", "npx", "-y", "react-icons-mcp", "--stdio"]
    }
  }
}

Running Locally

You can also run the server directly:

# Run in HTTP mode (default port 3334)
npx react-icons-mcp

# Run in stdio mode for direct integration with AI tools
npx react-icons-mcp --stdio

# Run on a custom port
npx react-icons-mcp --port 3456

Tools Available

This MCP server exposes the following tools to AI coding assistants:

  1. get_icon_libraries - Get information about all available icon libraries
  2. search_icons - Search for icons by name or category
  3. get_library_icons - Get all icons from a specific library
  4. get_icon_details - Get detailed information about a specific icon
  5. get_icon_usage_examples - Get code examples for using React Icons

Example Usage

Here's how an AI tool might use this MCP server to help a developer:

  1. User asks: "I need a user icon for my React app"
  2. AI tool calls search_icons with query "user"
  3. AI tool receives a list of user-related icons from various libraries
  4. AI tool suggests: "You can use the FaUser icon from Font Awesome with this code snippet:"
import { FaUser } from 'react-icons/fa';

function UserProfile() {
  return (
    <div>
      <FaUser size={24} />
      <span>User Profile</span>
    </div>
  );
}

Development

# Clone the repository
git clone https://github.com/yourusername/react-icons-mcp.git
cd react-icons-mcp

# Install dependencies
npm install

# Build the project
npm run build

# Run in development mode with hot reloading
npm run dev

License

MIT