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 分