Icons8 MCP server

官方

Icons8 MCP将AI编程助手连接到Icons8内部绘制的艺术作品:130多种风格下的42万多个图标,以及340多种风格下的11万多幅插图。助手会挑选匹配的素材并直接将其放入代码中。连接到https://mcp.icons8.com/mcp/并使用Icons8账户登录。只要项目通过链接注明Icons8来源,PNG下载就免费;SVG则需要付费订阅。

你可以用 Icons8 MCP 做什么?

  • 按关键词和样式搜索图标 — 询问类似“彩色风格的 analytics SVG 图标”即可通过 search_icons 获取匹配结果。
  • 浏览可用类别和平台 — 让助手使用 list_categories 和 list_platforms 列出图标类别或特定平台的图标集。
  • 获取免费高清 PNG 图标 URL — 通过 get_icon_png_url 请求任何图标的直接 PNG 下载链接,所有套餐均可用。
  • 获取 SVG 图标用于生产环境 — 在付费套餐中,可使用 get_icon_svg 请求可缩放的 SVG 版本图标,以获得生产就绪资源。
  • 直接在 IDE 中使用图标进行原型设计 — 无需离开编码环境,即可将图标添加到仪表板、功能列表或 UI 原型中。

文档

Icons8 MCP 服务器

Icons8 MCP 服务器让 AI 编码环境即时访问 420,000+ 个 Icons8 图标,涵盖 130+ 种设计风格,以及 340+ 种风格下的 110,000+ 幅插画。连接你的 Claude、Cursor、Windsurf、VS Code 或任何 MCP 主机,登录一次,即可免费流式获取高清 PNG,或通过付费计划解锁完整 SVG 交付——非常适合原型设计、生产代码和快速 UI 实验。

使用场景

  • 用一致、时尚的风格替换现有项目中的整套图标集。
  • 无需离开 IDE,即可为项目符号列表、功能亮点、流程步骤和仪表板添加图标。
  • 使用免费 PNG 预览快速制作原型,然后升级到 SVG 以获得生产级资源。
  • 构建 AI 辅助工作流,直接在代码中搜索、预览和插入图标。
  • 通过现成的演示(如下落的 emoji、科幻仪表板和产品目录)展示交互性。

工作原理

Icons8 MCP 端点托管在 https://mcp.icons8.com/mcp/,使用 MCP Streamable HTTP 传输协议。你的客户端直接连接到它——无需安装本地进程,也无需在编辑器旁边运行任何东西。

前提条件

  1. 支持 MCP 的编辑器或代理主机(Claude Code、Cursor、Windsurf、VS Code 等)。
  2. 一个 Icons8 账户。服务器使用 OAuth 进行身份验证,因此首次连接会打开浏览器并要求你登录。

第 1 步:连接

一个配置即可覆盖所有内容。将你的客户端指向该端点:

{
  "mcpServers": {
    "icons8mcp": {
      "type": "http",
      "url": "https://mcp.icons8.com/mcp/"
    }
  }
}

当浏览器打开时登录,搜索和高清 PNG 即可使用。会出现四个工具: search_icons、list_categories、list_platforms 和 get_icon_png_url。

第 2 步:在需要时解锁 SVG

SVG 是生产格式,需要付费计划。订阅 $15,你已登录的账户将自动携带该计划——无需添加第二个服务器,也无需切换第二个配置。第五个工具 get_icon_svg 将加入其他四个工具。

如果你的代理仍然返回 PNG,请重新登录以使其获取新计划:Claude Code 中使用 /mcp,Codex 中使用 codex mcp login icons8mcp,Cursor 中使用 Connect。

不支持 OAuth 的客户端

改用 API 密钥。你的 Icons8 账户的 MCP 选项卡中已有包含你的密钥的代码片段,也可以手动添加请求头:

{
  "mcpServers": {
    "icons8mcp": {
      "type": "http",
      "url": "https://mcp.icons8.com/mcp/",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

使用密钥可以完全跳过浏览器,这也正是你在构建服务器或 CI 中想要的场景,因为那里没有人可以登录。之前已经用密钥设置过?保持原样即可——它仍然有效。

配置你的客户端

Claude Code

  1. 打开终端并运行:
    claude mcp add --transport http icons8mcp https://mcp.icons8.com/mcp/
    
  2. 验证服务器已注册,并使用 /mcp 登录:
    claude mcp list
    
    登录前状态显示为 Needs authentication——这表示端点已响应,而不是设置有问题。

Codex

  1. 添加服务器并登录:
    codex mcp add icons8mcp --url https://mcp.icons8.com/mcp/
    codex mcp login icons8mcp
    

Cursor

  1. Cursor → Settings → Cursor Settings → MCP 选项卡。
  2. 点击 + Add new global MCP server。
  3. 粘贴第 1 步中的 JSON,然后点击 Connect 登录。

Windsurf

  1. Windsurf → Settings → Windsurf Settings → MCP 部分。
  2. 管理插件 → View raw config。
  3. 粘贴 JSON 配置并保存。

VS Code(代理模式)

  1. Code → Settings → Settings → 搜索“MCP”。
  2. 选择 Edit in settings.json。
  3. 添加 JSON 配置。
  4. 打开聊天工具栏(⌥⌘B),切换到 Agent 模式,并在 MCP Server: Icons8 MCP 下查找工具。如果工具没有立即出现,请重启 VS Code。

任何其他 MCP 主机 使用第 1 步中的相同 JSON。如果主机支持 OAuth,它会引导你完成登录;如果不支持,请添加上面显示的 Authorization 请求头。请查阅主机文档,了解在哪里粘贴 MCP 服务器设置。

主机对此传输协议的称呼不同——http、streamable-http,或者在重命名之前的客户端中称为 SSE。它们都指通过 HTTP 的同一个远程端点,因此请选择你的主机提供的任意一个,并给它上面的 URL。

开始使用图标构建

向你的 AI 助手询问你需要的图标,例如“创建一个彩色风格的 analytics SVG 图标仪表板”或“添加 iOS glyph 风格的 MCP server 图标 SVG”。浏览下面的实时演示获取灵感,如果某些功能不符合预期,请查看常见问题解答。


实时演示


常见问题解答

我的客户端提示服务器需要身份验证。是出问题了吗?
不是——这是登录前的正常状态。端点已响应;它正在等待你。请使用 Claude Code 中的 /mcp、Codex 中的 codex mcp login icons8mcp 或 Cursor 中的 Connect 登录。

如何专门获取 SVG 图标?
在你的提示中明确请求 SVG 图标,并确保连接携带付费计划——无论是你登录的账户,还是 Authorization 请求头中的 API 密钥。

有哪些可用格式?
PNG 在所有计划下都可用。SVG 下载需要付费计划。

我可以免费下载 PNG 图标吗?
可以。登录后即可免费获取高清 PNG;无需付费计划,也无需 API 密钥。

免费计划的许可条款是什么?
免费 PNG 使用需要署名并链接回 Icons8。查看 Icons8 许可证了解完整详情。

我需要 API 密钥吗?
仅当你的客户端不支持 OAuth,或在构建服务器上没有人可以登录时才需要。其他所有情况下,登录即可替代密钥——而且携带计划的是账户,而不是密钥。

我请求了 SVG 但收到了 PNG。发生了什么?
get_icon_svg 仅在连接处于付费计划时才会出现,因此代理回退到了 PNG。如果你在连接后订阅了,请重新登录以获取新计划,然后明确请求 SVG。

我还需要 Node.js 或 npx mcp-remote 吗?
不需要。服务器使用 Streamable HTTP,因此你的客户端直接连接到它。如果你有旧的 npx mcp-remote 配置,它仍然可以工作,但你可以用上面的普通 URL 替换它。

我可以批量下载图标吗?
批量下载功能正在开发中——敬请期待。

需要帮助?
查看上面的设置步骤或与我们聊天。


更多来自 Icons8

图标只是开始——Icons8 还提供 110,000+ 幅插画,涵盖 340+ 种风格(3D Casual Life、Cherry、3D Stickle)以及 Mega Creator 用于完整图形设计。

致谢