Supericons MCP

Supericons v2.0

为 AI 编码 Agent 提供语义 SVG 图标搜索、预览和推荐。

Supericons 帮助 Agent 按含义而非仅按文件名查找图标。它可搜索 11 个图标库中的 20,000 多个免费图标，并可返回 SVG 代码或视觉对比结果。

发布版本

Supericons 为产品插件和 MCP 运行时使用不同的版本号：

组件	当前版本
Supericons 插件	2.0.0
npm MCP 运行时	@supericons/[email protected]
托管 MCP 运行时	0.4.22

v2.0 插件使用当前 MCP 运行时。没有名为 @supericons/[email protected] 的 npm 包。

快速开始

对于支持远程 MCP 服务的客户端，请使用托管端点：

https://mcp.supericons.dev/mcp

对于使用本地 MCP 命令的客户端，请使用：

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

免费工具无需 Supericons API 密钥。

插件文件

此仓库包含适用于 Codex、Claude Code 和兼容 Agent 目录的公开插件清单：

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

Codex 插件还使用：

.codex-mcp.json
skills/supericons-icon-search/SKILL.md

手动设置字段

如果客户端显示的是表单而非配置文件，请填写：

Name: supericons
Transport: stdio
Command: npx
Arguments:
-y
@supericons/mcp@latest

如果只有一个参数字段，请填写：

-y @supericons/mcp@latest

托管工具

search_icons ：按含义、标签、视觉描述、标签词、同义词和支持的多语言词条进行搜索。

recommend_icons ：为最多 20 个已命名的 UI 槽位推荐一组风格一致的图标。

get_icon ：在已知图标 ID 和图标库的情况下，获取一个指定的 SVG 图标。

preview_icons ：在托管预览页面或图像上对比搜索结果或已知图标引用。

list_libraries ：列出托管服务器提供的 11 个免费图标库。

示例提示词

Use Supericons to find a Lucide database icon. Show the icon id, library, and SVG.

Use Supericons to recommend icons for an AI dashboard sidebar: model, prompt, dataset, evaluation, deployment, and monitoring. Prefer Lucide outline icons.

Use Supericons to preview the strongest camera scan icons so I can compare them visually.

Pro 设置

如需 Pro 权限，请将 API 密钥添加为环境变量：

SUPERICONS_API_KEY=<YOUR_SUPERICONS_API_KEY>

切勿将 API 密钥粘贴到公开问题、截图、已提交的配置文件或共享聊天中。

链接

• 网站：https://supericons.dev
• MCP 设置：https://supericons.dev/mcp/
• npm 包：https://www.npmjs.com/package/@supericons/mcp
• 托管 MCP：https://mcp.supericons.dev/mcp
• 服务卡片：https://mcp.supericons.dev/.well-known/mcp/server-card.json

公开仓库范围

此仓库是 Supericons 的公开设置和目录封装。仓库包含公开清单、安装示例、支持信息和品牌素材。私有产品代码、凭据、客户数据和内部运营数据均不属于此仓库。