infyicon-mcp

Infyicon MCP Server

通过任意 AI 助手搜索 161,000+ 款免费手绘矢量图标，包括 Claude、ChatGPT、Cursor、VS Code / Copilot、Codex、Gemini、Windsurf、Zed、Cline、Goose、LM Studio、JetBrains 以及所有其他 MCP 客户端。提供四种匹配样式（轮廓、填充、彩色轮廓、彩色填充）、可直接嵌入的 SVG 标记、16–512 px 透明 PNG，以及包含 61,000 个字形的 UI 网页字体。

• 托管端点（推荐）： https://infyicon.com/mcp — 可流式传输的 HTTP、无状态、无需身份验证，无需 API 密钥，所有工具均为只读
• 一键安装按钮 + 适用于所有客户端的复制粘贴配置： https://infyicon.com/connect
• 图标许可证： 免费供个人和商业用途，需注明来源 infyicon.com — https://infyicon.com/license

工具（v1.2.0）

工具	功能
search_icons	搜索 161,000+ 款图标的关键词，可选样式筛选，支持偏移分页。返回 ID、名称、页面/SVG/PNG URL 和标签。
get_popular_icons	没有搜索词时显示精选图标。
get_related_icons	跨样式查找相同主题的图标，可用于搭配成套或提供不同选项。
get_icon_svg	获取单个图标 ID 对应的完整 SVG 标记，可直接嵌入。
get_icon_svg_bulk	一次调用获取 1–20 个图标 ID 对应的 SVG 标记。
get_icon_png	获取 16 / 24 / 32 / 64 / 128 / 256 / 512 px 的透明 PNG URL。
list_categories	获取最热门的类别、数量和类别页面 URL。
search_uicons	获取 Infyicon UI 网页字体中的 CSS 类名（<i class="ii-r-home"></i>）。

v1.0/1.1 中的旧名称（popular_icons、related_icons、bulk_svg、uicons_lookup）仍作为别名接受。

快速开始

Claude.ai / Claude Desktop — 设置 → 连接器 → 添加自定义连接器 → https://infyicon.com/mcp。也可以安装桌面扩展：infyicon.mcpb。

Claude Code

claude mcp add --transport http infyicon https://infyicon.com/mcp
# or as a plugin
claude plugin marketplace add krupalghori44-dev/infyicon-mcp && claude plugin install infyicon@infyicon

ChatGPT — 设置 → 应用和连接器 → 高级 → 开发者模式 → 创建 → MCP URL https://infyicon.com/mcp，身份验证 None。

Cursor — 添加到 Cursor 或使用 ~/.cursor/mcp.json：

{ "mcpServers": { "infyicon": { "url": "https://infyicon.com/mcp" } } }

VS Code / GitHub Copilot — .vscode/mcp.json：

{ "servers": { "infyicon": { "type": "http", "url": "https://infyicon.com/mcp" } } }

Codex CLI — codex mcp add infyicon --url https://infyicon.com/mcp

Gemini CLI（扩展，推荐） — gemini extensions install https://github.com/krupalghori44-dev/infyicon-mcp — 添加服务、/icons <query> 命令和使用上下文。也可以使用纯 MCP：gemini mcp add --transport http infyicon https://infyicon.com/mcp · Gemini 应用 — 设置 → 已连接的应用 → 添加自定义 MCP 服务

Windsurf — { "mcpServers": { "infyicon": { "serverUrl": "https://infyicon.com/mcp" } } }

Cline / Roo Code — { "mcpServers": { "infyicon": { "type": "streamableHttp", "url": "https://infyicon.com/mcp" } } }

任何仅支持 stdio 的客户端（Zed、Goose、LM Studio、JetBrains、Perplexity…） — 零依赖 npm 桥接程序会将请求转发到托管服务：

{ "mcpServers": { "infyicon": { "command": "npx", "args": ["-y", "infyicon-mcp"] } } }

自行运行

npx -y infyicon-mcp             # stdio bridge
npx -y infyicon-mcp --http 3000 # local HTTP mirror at POST http://127.0.0.1:3000/mcp
docker build -t infyicon-mcp . && docker run -i infyicon-mcp

standalone.js 会将 initialize、tools/list 和 tools/call 转发到 https://infyicon.com/mcp（可通过 INFYICON_MCP_UPSTREAM 覆盖），因此始终保持最新。mcp.js 是在 infyicon.com 上运行的参考实现（Express、手写 JSON-RPC、不使用 SDK）。

仓库结构

• standalone.js — npm 包 infyicon-mcp（stdio / --http）
• mcp.js — 托管服务源代码
• mcpb/ — Claude Desktop 扩展源代码；使用 npx @anthropic-ai/mcpb pack mcpb dist/infyicon.mcpb 构建
• .claude-plugin/ + .mcp.json — Claude Code 插件市场
• gemini-extension.json + GEMINI.md + commands/ — Gemini CLI 扩展（/icons 命令）
• connect/connect.html — 在 https://infyicon.com/connect 提供的一键设置页面
• server.json — Official MCP Registry 清单

隐私

工具参数（搜索词、图标 ID、样式筛选条件）会通过 HTTPS 发送至 infyicon.com；响应包含图标元数据、SVG 标记和 PNG URL。无需账户或 API 密钥；不进行遥测，也不访问本地文件。隐私政策：https://infyicon.com/privacy · 联系方式：[email protected]

许可证

服务和桥接代码：MIT。图标：免费使用，需注明出处 — https://infyicon.com/license