unicon-mcp

Original：🇺🇸 English
Translated

Help users connect the Unicon MCP server to Claude Desktop, Cursor, and other MCP clients. Use when setting up MCP config, verifying installs, debugging MCP connection issues, or using Unicon tools for icon search and generation through AI assistants.

6installs
Sourcewebrenew/unicon
Added on

NPX Install

npx skill4agent add webrenew/unicon unicon-mcp

Tags

Translated version includes tags in frontmatter
unicon-mcp-servericon-generationmcp-client-setupai-assistant-integrationtroubleshooting

SKILL.md Content

View Translation Comparison →

Unicon MCP

Use the Unicon MCP server to search and generate icon components through AI assistants like Claude Desktop and Cursor.

Quick Start

Claude Desktop

  1. Open 
    ~/Library/Application Support/Claude/claude_desktop_config.json
  2. Add:
json
{
  "mcpServers": {
    "unicon": {
      "command": "npx",
      "args": ["-y", "@webrenew/unicon-mcp-server"]
    }
  }
}
  1. Fully quit and restart Claude Desktop.

Cursor

  1. Open Settings > MCP Servers
  2. Add the same JSON config shown above
  3. Restart Cursor

Verify Installation

  • Claude Desktop: look for the plug icon, ensure 
    unicon
    appears
  • Cursor: run 
    claude mcp list
    if using Claude Code

Common Prompts

  • "Search for dashboard icons in Lucide"
  • "Get React component for lucide:arrow-right"
  • "Generate Vue components for social media icons"
  • "List available icon libraries"

Available Tools

search_icons

Search through 19,000+ icons with optional filters.
Parameters
ParameterRequiredDescription
query
YesSearch term
source
NoFilter by library
category
NoFilter by category
limit
NoMax results (default: 20)
includeCode
NoReturn code with results
strokeWidth
NoStroke width when includeCode=true
normalizeStrokes
NoNormalize stroke widths, skipping fill icons

get_icon

Return code for a single icon in a requested format.
Parameters
ParameterRequiredDescription
iconId
YesIcon ID (e.g., "lucide:home")
format
Nosvg, react, vue, svelte, json
size
NoIcon size in pixels
strokeWidth
NoStroke width
normalizeStrokes
NoNormalize stroke widths, skipping fill icons

get_multiple_icons

Fetch up to 50 icons at once in a shared format.
Parameters
ParameterRequiredDescription
iconIds
YesArray of icon IDs
format
NoOutput format
size
NoIcon size in pixels
strokeWidth
NoStroke width
normalizeStrokes
NoNormalize stroke widths, skipping fill icons

get_starter_pack

Get curated icon packs for common use cases.
Parameters
ParameterRequiredDescription
packId
YesPack identifier
format
NoOutput format
size
NoIcon size in pixels
strokeWidth
NoStroke width
normalizeStrokes
NoNormalize stroke widths, skipping fill icons

Resources

The MCP server exposes these resources:
URIDescription
unicon://sources
Library metadata (names, icon counts)
unicon://categories
Available category list
unicon://stats
Overall icon statistics
unicon://starter_packs
Curated icon packs (shadcn-ui, dashboard, etc.)
unicon://instructions
Detailed usage guide with examples

Troubleshooting

Server not appearing

  1. Fully quit the app (Cmd+Q on macOS)
  2. Verify config JSON syntax is valid
  3. Restart the application
  4. Check for error logs

Slow first start

The first 
npx
run downloads the package. Subsequent runs use cache.

Icons not found

Run 
search_icons
with your query to verify the icon ID exists. Format is 
source:name
(e.g., 
lucide:home
).

Connection errors

  1. Ensure you have Node.js 18+ installed
  2. Check internet connectivity
  3. Try running manually: 
    npx @webrenew/unicon-mcp-server