mcpField
M
Mingcute Icons Mcp

Mingcute Icons Mcp

Local
github.com/mingcute-designDeveloper Tools1Updated 23w ago
Repository

About Mingcute Icons Mcp

Mingcute Icons Mcp is an MCP server for AI coding assistants to find MingCute icons and obtain implementation examples. It supports bilingual search and several formats, using a local icon index rather than a runtime remote API.

Key features

  1. 01Search by English or Chinese terms
  2. 02Filter icons by style
  3. 03Get icon details and raw SVG
  4. 04Browse categories and their icons
  5. 05Generate React, Vue, webfont, and SVG examples

Use cases

  1. 01Find an icon by name or UI concept
  2. 02Choose a line or fill variant
  3. 03Retrieve SVG source for an interface
  4. 04Get code examples for a target format

MCP support

Exposes MingCute icon search, details, category listings, SVG source, and usage examples as tools for MCP clients.

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

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "mingcute-icons": {
      "command": "npx",
      "args": [
        "-y",
        "@mingcute/mcp-server"
      ]
    }
  }
}
Run commandnpx -y @mingcute/mcp-server

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npm@mingcute/mcp-server

Tools

5

Saved tool list · updated 3w ago

ParameterTypeRequiredDescription
querystringYesSearch query, such as home, 主页, arrow, settings
styleenumNoVariant style: line, fill, or allline | fill | all
categorystringNoOptional MingCute category filter
limitnumberNoMaximum results to return
localeenumNoQuery language hintauto | en | zh

Details

From the project README

MingCute Icon MCP

MingCute Icon MCP is a Model Context Protocol server for AI coding assistants to search and use MingCute icons in MCP-compatible tools such as Claude, Codex, Cursor, Windsurf, and Cline.

Features

  • Search MingCute icons by English or Chinese keyword, icon name, component name, category, and style.
  • Filter by line, fill, or all styles so AI assistants can pick the right variant for the UI context.
  • Generate React, Vue, webfont, and SVG usage examples with the matching published npm package.
  • Fetch icon details, categories, icons by category, and raw SVG source when needed.
  • Runs from a local icon index and does not depend on a remote API at runtime.

Usage

npx -y @mingcute/mcp-server
Codex
codex mcp add mingcute -- npx -y @mingcute/mcp-server
Claude Desktop
{
  "mcpServers": {
    "mingcute": {
      "command": "npx",
      "args": ["-y", "@mingcute/mcp-server"]
    }
  }
}

Tools

search_icons

Search by English or Chinese keyword, icon name, component name, category, and style.

{
  "query": "home",
  "style": "line",
  "limit": 5
}
get_icon

Get one icon set by base name or variant name.

{
  "name": "home_1",
  "style": "all",
  "includeSvg": false
}
get_icon_usage

Generate usage examples for React, Vue, webfont, or SVG.

{
  "name": "home_1",
  "style": "line",
  "framework": "react"
}

React examples use @mingcute/react, Vue examples use @mingcute/vue, and SVG/webfont examples use mingcute_icon.

list_categories

List MingCute categories.

list_icons_by_category

List icons in one category.

{
  "category": "building",
  "style": "fill",
  "limit": 20
}

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.