mcp-icon
Allows searching over 100,000 SVG icons from the AntV Infographic icon library using semantic search, returning SVG URLs for use in infographics.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@mcp-icon search for an icon representing data analytics"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
๐จ mcp-icon
A Model Context Protocol (MCP) server for semantic SVG icon search.
Generate infographic SVG icons by keyword โ over 100,000 icons with semantic search support, powered by AntV Infographic.
๐ Table of Contents
Related MCP server: icogenie-mcp
โจ Features
๐ Semantic search โ Find icons by meaning, not just exact names
๐ผ๏ธ 100,000+ SVG icons โ A massive library of high-quality infographic icons
โก Three transport modes โ
stdio,sse, andstreamable-http๐ชถ Minimal dependencies โ Clean, focused implementation
๐งช Fully tested โ Unit tests with Vitest
Available Tool
Tool | Description |
| Search for SVG icons by keyword. Returns a list of SVG URLs matching the semantic query. |
search_icons parameters:
Parameter | Type | Required | Default | Description |
| string | โ | โ | Search keyword or phrase (e.g. |
| number | โ |
| Number of icons to return (1โ20) |
๐ค Usage
Add to your MCP client configuration (e.g. Claude Desktop, VS Code, Cursor):
macOS / Linux:
{
"mcpServers": {
"mcp-icon": {
"command": "npx",
"args": ["-y", "mcp-icon"]
}
}
}Windows:
{
"mcpServers": {
"mcp-icon": {
"command": "cmd",
"args": ["/c", "npx", "-y", "mcp-icon"]
}
}
}๐ฐ Transport Modes
mcp-icon supports three standard MCP transport protocols.
stdio (default)
Used by desktop MCP clients (Claude Desktop, Cursor, etc.):
npx mcp-icon
# or explicitly:
npx mcp-icon --transport stdioSSE (Server-Sent Events)
npx mcp-icon --transport sse --port 3456
# Server available at: http://localhost:3456/sseStreamable HTTP
npx mcp-icon --transport streamable --port 3456
# Server available at: http://localhost:3456/mcp๐ฎ CLI Options
mcp-icon CLI
Options:
--transport, -t Transport protocol: "stdio", "sse", or "streamable" (default: "stdio")
--host, -h Host for SSE or streamable transport (default: localhost)
--port, -p Port for SSE or streamable transport (default: 3456)
--endpoint, -e Endpoint path:
- For SSE: default is "/sse"
- For streamable: default is "/mcp"
--help, -H Show this help message๐จ Development
# Clone the repository
git clone https://github.com/hustcc/mcp-icon.git
cd mcp-icon
# Install dependencies
npm install
# Build
npm run build
# Run tests
npm test
# Start with MCP inspector (for local debugging)
npm startProject Structure
src/
โโโ index.ts # CLI entry point
โโโ server.ts # MCP server + tool handlers
โโโ services/
โ โโโ stdio.ts # Stdio transport
โ โโโ sse.ts # SSE transport
โ โโโ streamable.ts # Streamable HTTP transport
โโโ tools/
โ โโโ search-icons.ts # Tool definition
โโโ utils/
โโโ api.ts # Icon search API client
โโโ logger.ts # Logger utility
tests/
โโโ api.test.ts # API client unit tests
โโโ server.test.ts # MCP server integration tests๐ License
MIT ยฉ hustcc
Available Tools
1 toolsearch_iconsA
Search for SVG icons by keyword using semantic search. Returns URLs of matching SVG icons from a library of over 100,000 infographic icons.
Inputs: keyword (required), topK.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelogโฆ
TDQS
Scored across 1 tool
With only one tool, there is no possibility of confusion or overlap between tools. The single tool's purpose is clear and unambiguous.
The tool name 'search_icons' follows a clear verb_noun pattern, which is consistent and predictable. There are no other tools to compare against, so consistency is perfect.
A single tool for an icon server is too few. The server name implies a broader scope, and one tool feels insufficient for handling icon-related operations beyond searching.
The tool surface is severely incomplete for an icon service. Only search is offered; there are no tools for retrieving specific icons, listing categories, or managing icons, leaving significant gaps.
Maintenance
Related MCP Connectors
Stimulsoft Reports & Dashboards docs MCP server. Semantic search for all platforms.
Capability registry for the agentic economy. Semantic search over verified MCP server listings.
Personal knowledge base MCP server with semantic search, auto-categorization, metadata extraction
One MCP server for all web data. Scrape, search, crawl, and AI research in one install.
Related MCP Servers
AlicenseAqualityCmaintenanceAn MCP server that enables users to search the Remix Icon catalog by mapping keywords to icon metadata using a high-performance local index. It returns the top five most relevant icon matches with categories and tags to streamline icon selection for design and development tasks.184 npm96MIT- AlicenseNot gradedqualityDmaintenanceAI-powered SVG icon generation MCP server. Generate production-ready SVG icons from text descriptions with customizable styles, sizes, and themes.93 npm8MIT
- AlicenseBqualityDmaintenanceA Model Context Protocol server for searching and fetching icons from iconfont.cn.328 npm9MIT
- AlicenseAqualityCmaintenanceMCP server for searching and exporting Apple SF Symbols as true vector SVGs.41MIT