Infyicon MCP Server 是一个 MCP（Model Context Protocol）服务器，让 AI 助手能够直接搜索并获取 Infyicon 的手绘风格图标资源。它面向需要在对话或编码环境中快速调用图标素材的用户，支持从 Claude、ChatGPT、Cursor、VS Code / Copilot、Codex、Gemini、Windsurf、Zed、Cline、Goose、LM Studio、JetBrains 等任何 MCP 客户端访问。
主要能力：
- 搜索 161,000+ 免费手绘矢量图标。
- 提供四种匹配风格：outline、fill、color-outline、color-fill。
- 返回可直接嵌入的 SVG 标记。
- 提供 16–512 像素的透明 PNG 图片链接。
- 附带包含 61,000 个字形的 UI 网络字体。
- 所有工具均为只读操作。
使用方式： 推荐使用托管端点 https://infyicon.com/mcp，该端点采用可流式 HTTP、无状态设计，无需认证、无需 API 密钥。官方提供一键安装按钮和针对各客户端的复制粘贴配置，详见 https://infyicon.com/connect。
各客户端接入示例：
- Claude.ai / Claude Desktop：设置 → Connectors → Add custom connector → 填入 https://infyicon.com/mcp；或安装桌面扩展 infyicon.mcpb。
- ChatGPT：设置 → Apps & Connectors → Advanced → Developer mode → Create → MCP URL 填 https://infyicon.com/mcp，auth 选 None。
- Cursor：添加到 Cursor 或 ~/.cursor/mcp.json。
- VS Code / GitHub Copilot：配置 .vscode/mcp.json。
- 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 应用：设置 → Connected apps → Add custom MCP server。
- 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 桥接程序转发到托管服务器。
自行运行： 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 — 官方 MCP Registry 清单
适用场景： 适合在 AI 对话、代码编辑或设计辅助过程中需要快速查找并嵌入手绘图标的用户，尤其是使用支持 MCP 协议的 AI 客户端进行开发或内容创作时。
限制与说明：
- 工具参数（搜索词、图标 ID、风格过滤）会通过 HTTPS 发送到 infyicon.com；响应包含图标元数据、SVG 标记和 PNG 链接。
- 无需账户、API 密钥、遥测或本地文件访问。
- 隐私政策：https://infyicon.com/privacy；联系方式：info@infyicon.com。
- 服务器和桥接代码采用 MIT 许可；图标免费使用但需注明来源，详见 https://infyicon.com/license。
- v1.0/1.1 中的旧名称（popular_icons、related_icons、bulk_svg、uicons_lookup）仍作为别名被接受。
