Supericons

io.github.curlymolelabs由 GitHub 账号 curlymolelabs 发布v0.4.22更新于 Nov 2, 2026

Multilingual semantic SVG icon search with previews for AI coding agents. 20,000+ icons.

已验证Streamable HTTP可网页运行开发者工具媒体与设计

概览

AI 生成的概览

Supericons 让助手按语义在 11 个图标库的 2 万多个免费 SVG 图标中搜索、预览，并返回可直接使用的 SVG 代码。

可以做什么
  • 按含义、名称、视觉描述、标签、同义词和多语言词条搜索图标，并给出预览图与 Markdown。
  • 为最多 20 个具名 UI 位置推荐风格一致的图标组合，上下文不足时会请求澄清。
  • 按精确引用获取单个 SVG 图标，附图标库标签与预览地址。
  • 在托管预览页或 PNG 图片上预览、比较已知图标引用。
  • 列出托管服务器提供的免费图标库。
适用场景
适合在搭建或修改界面时，让助手按含义而非文件名挑选合适图标，或为某个页面配一套风格统一的图标。也适合在最终选定前直观比较几个候选图标。
运行要求
可使用托管的远程端点，或用 npx 从 npm 包启动本地进程。免费工具无需 API 密钥；Pro 访问需设置 SUPERICONS_API_KEY 环境变量。搜索与托管预览需要网络访问。
安装前请注意
Pro 访问需要 SUPERICONS_API_KEY 中的 API 密钥，请勿将其粘贴到公开 issue、截图、提交到仓库的配置文件或共享聊天中。搜索词与图标引用会发送到托管服务，预览图片也由其服务器加载。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Supericons，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Web executable，通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体，或 SourceWeft 对话中。智能体会读取该服务器的安装指南，先向你展示发布者、端点和登录方式，经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/io.github.curlymolelabs%2Fsupericons/install.md，并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前，先告诉我它的发布者、端点和登录方式，等我确认。不要把 API 密钥写进命令或我会提交的文件；问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

{
  "mcpServers": {
    "supericons": {
      "type": "http",
      "url": "https://mcp.supericons.dev/mcp"
    }
  }
}

README

Supericons v2.0

Semantic SVG icon search, previews, and recommendations for AI coding agents.

Supericons helps agents find icons by meaning, not only by file name. It searches 20,000+ free icons across 11 libraries and can return SVG code or a visual comparison.

Release versions

Supericons uses separate versions for the product plugin and its MCP runtime:

ComponentCurrent release
Supericons plugin2.0.0
npm MCP runtime@supericons/[email protected]
Hosted MCP runtime0.4.22

The v2.0 plugin uses the current MCP runtime. There is no npm package named @supericons/[email protected].

Quick start

For clients that support remote MCP servers, use the hosted endpoint:

text
https://mcp.supericons.dev/mcp

For clients that use local MCP commands, use:

json
{  "mcpServers": {    "supericons": {      "command": "npx",      "args": ["-y", "@supericons/mcp@latest"]    }  }}

The free tools do not need a Supericons API key.

Plugin files

This repository includes public plugin manifests for Codex, Claude Code, and compatible agent directories:

text
.plugin/plugin.json.codex-plugin/plugin.json.claude-plugin/plugin.json.agents/plugins/marketplace.json

The Codex plugin also uses:

text
.codex-mcp.jsonskills/supericons-icon-search/SKILL.md

Manual setup fields

If your client shows a form instead of a config file, enter:

text
Name: supericonsTransport: stdioCommand: npxArguments:-y@supericons/mcp@latest

If it has one argument field, enter:

text
-y @supericons/mcp@latest

Hosted tools

search_icons : Search by meaning, label, visual description, tags, synonyms, and supported multilingual terms.

recommend_icons : Recommend a consistent icon set for up to 20 named UI slots.

get_icon : Retrieve one exact SVG icon when its icon ID and library are known.

preview_icons : Compare search results or known icon references on a hosted preview page or image.

list_libraries : List the 11 free icon libraries available through the hosted server.

Example prompts

text
Use Supericons to find a Lucide database icon. Show the icon id, library, and SVG.
text
Use Supericons to recommend icons for an AI dashboard sidebar: model, prompt, dataset, evaluation, deployment, and monitoring. Prefer Lucide outline icons.
text
Use Supericons to preview the strongest camera scan icons so I can compare them visually.

Pro setup

For Pro access, add the API key as an environment variable:

text
SUPERICONS_API_KEY=<YOUR_SUPERICONS_API_KEY>

Never paste an API key into a public issue, screenshot, committed config file, or shared chat.

Links

Public repository scope

This repository is the public setup and directory wrapper for Supericons. It contains public manifests, install examples, support information, and brand assets. Private product code, credentials, customer data, and internal operating data are not part of this repository.

来源：README.md，提交 8875d68

工具

5

search_icons

Search Icons

Use this as the main icon tool. Search 20,000+ curated SVG icons across 11 libraries by meaning, label, visual description, tags, and synonyms. When matches exist, the response includes a paste-ready suggested answer, a direct preview image, and Markdown that can show the image in the final reply. When no supported match exists, it returns an honest structured no-result with a next step and no fabricated icon. If you choose a library yourself, use prefer. Use strict only when the user explicitly requires that library. Library key si means Supericons, not Simple Icons.

输入参数limitquery必填stylelocalelibrarylibrary_modeinclude_query_frame

recommend_icons

Recommend Icons

Recommend a coherent icon set for up to 20 named UI slots in one call. Uses task context to narrow ambiguous meanings. When context is insufficient, returns needs_clarification with labeled interpretation options instead of guessing. Invalid inputs and service failures return a plain-language reason and a next step instead of a bare protocol error. Returns one recommendation and optional alternatives for each resolved slot, with explicit public library labels and visual preview URLs where available. Library key si means Supericons, not Simple Icons.

输入参数taskslotsstylelocalelibraryresponse_modelimit_per_slotinclude_query_frame

get_icon

Get Icon

Retrieve one exact SVG icon using an exact ref returned by search_icons, recommend_icons, or preview_icons. Do not guess icon IDs. Use search_icons first if the user only described a concept. Returns SVG code, explicit public library labels, visual preview URL, and public semantic guidance for the exact icon.

输入参数id必填stylelibrary必填

preview_icons

Preview Icons

Refine an icon result set or preview known icon refs returned by another Supericons tool. Use search_icons first for normal icon requests. Icon lists up to 100 refs are accepted and safely truncated to 12. Returns ready-to-use Markdown, a hosted preview fallback, a direct PNG image URL, and, when requested, an MCP image contact sheet.

输入参数limitquerystylelocalelibraryicon_refsinclude_image

list_libraries

List Libraries

List the free icon libraries available through the hosted Supericons MCP server. Use this before filtering by library or when a user asks which icon libraries are supported.

无需输入参数。

版本历史

1
  1. v0.4.22最新Sep 16, 2026

评分

已满足适用检查项的 100%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分