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
}