Mingcute Icons Mcp

@mingcute-design

About Mingcute Icons Mcp

MCP server for searching and using MingCute icons in AI coding assistants. It supports English and Chinese keyword search, icon details, categories, and usage examples for React, Vue, Webfont, and SVG.

#icons #mingcute #svg #react #vue #webfont #design #mcp

Config

Add this server to your MCP-compatible client using the configuration below.

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

Tools

Search MingCute icons by English or Chinese keywords, icon name, component name, category, and style. MingCute icons have line and fill variants.

Get one MingCute icon set by base name or variant name, optionally including SVG.

Generate usage examples for React, Vue, webfont, or SVG workflows using the published MingCute npm packages.

List all MingCute icon categories with icon and variant counts.

List MingCute icon sets in a category, optionally filtered by line or fill style.

Overview

What is Mingcute Icons Mcp?

Mingcute Icons Mcp is a Model Context Protocol server that allows AI coding assistants to search and retrieve MingCute icons for use in compatible tools like Claude, Codex, Cursor, Windsurf, and Cline.

How to use Mingcute Icons Mcp?

Run npx -y @mingcute/mcp-server to start the server. For Codex, use codex mcp add mingcute -- npx -y @mingcute/mcp-server. For Claude Desktop, add the JSON configuration shown in the README.

Key features of Mingcute Icons Mcp

Search by keyword, name, category, style in Chinese or English
Filter icons by line, fill, or all styles
Generate usage examples for React, Vue, webfont, SVG
Fetch icon details, categories, and raw SVG source
Operates from a local index, no runtime API dependency

Use cases of Mingcute Icons Mcp

Search icons during UI development in AI assistants
Generate React or Vue component code with icons
Find icons using Chinese keywords for Chinese-language projects
Fetch raw SVG for custom modifications
Browse icons by category for design exploration

FAQ from Mingcute Icons Mcp

What does Mingcute Icons Mcp do?

It allows AI coding assistants to search and retrieve MingCute icons, including filtering by style and generating code examples.

Which AI tools are compatible with Mingcute Icons Mcp?

It works with Claude, Codex, Cursor, Windsurf, and Cline.

Does Mingcute Icons Mcp require internet access?

No, it runs from a local icon index and does not depend on a remote API at runtime.

How do I install and run Mingcute Icons Mcp?

Use the command npx -y @mingcute/mcp-server. For Codex, use codex mcp add mingcute -- npx -y @mingcute/mcp-server. For Claude Desktop, add the provided JSON

Frequently asked questions