Icons8 MCP server

Icons8 MCP server

422,674 个 SVG 和 PNG 图标，覆盖 130 种风格，直接集成到你正在使用的 AI 编辑器中

免费使用

Product Hunt

当日产品

超大型图标包，单一风格最多可达 40,000 个图标

130 种风格可供选择

兼容

Claude Code、

Codex、

Cursor、

Windsurf

以及其他 AI 编程工具

将项目中的所有图标替换为时尚图标

或任何其他风格

为所有项目符号列表和功能区块添加图标，

处理步骤、导航等。

使用 Icons8 MCP 制作的演示

Emoji 风格 · 36 个图标

29 个图标，以内联 SVG 呈现

10 个图标，单一轮廓风格

Color 风格 · 27 个图标

如何使用 Icons8 MCP

你需要什么

• Claude Code、Codex、Cursor、Windsurf、VS Code 或类似的 AI 编程工具
• 在 Claude Code 和 Codex 中使用插件路线需要 Node.js：内置服务器通过 npx mcp-remote 运行。Cursor、Windsurf 和 VS Code 的手动配置直接通过 HTTP 通信，因此无需安装任何内容

第 1 步：连接 Icons8

Claude Code

Codex

Cursor

Windsurf

VS Code

其他

在终端中执行一行命令即可同时安装 MCP 服务器和 icons8 技能：

claude plugin marketplace add icons8/agent-skills && claude plugin install icons8@icons8

复制代码

首次使用时批准服务器，然后通过 /mcp 进行验证。这就是全部设置。

更想留在 Claude Code 里面？下面两条命令效果相同：

/plugin marketplace add icons8/agent-skills

复制代码

/plugin install icons8@icons8

复制代码

icons8 技能增加了什么

• 每个项目一种风格，保存到 icons8.json。提交该文件后，下一次会话会保持相同风格，而不是重新选择。
• 设置图标使用普通齿轮图标，而非同名的品牌 Logo。
• 迭代期间免费提供 PNG 预览，只有你确认的图标集才会提供 SVG。

MCP 为你的代理提供图标目录，技能则提供规则。没有它，代理会对每个标签取第一个搜索结果，这就是为什么一个界面最终会混用四种不同风格的图标。基于 Apache-2.0 开源：github.com/icons8/agent-skills。

第 2 步：在需要时解锁 SVG

以上功能已经全部可用：搜索、PNG 预览、任意尺寸的高分辨率 PNG。SVG 是生产环境格式，需要密钥。

密钥解锁第五个工具，get_icon_svg：目录中任何风格的真实 SVG，可干净缩放并跟随文字颜色。PNG 保持免费，并附带指向 Icons8 的链接。订阅 $15，然后从账户的 MCP 标签页获取现成的设置代码：其中已填入你的密钥。或者手动将密钥添加到任何配置中：

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

复制代码

在 Claude Code 中，同样的操作只需要一条命令：

claude mcp add --transport http icons8mcp-svg https://mcp.icons8.com/mcp/ --header "Authorization: Bearer YOUR_API_KEY"

复制代码

确认密钥是否生效：运行 claude mcp list。看到五个工具说明密钥已到达，第五个就是 get_icon_svg。如果只有四个工具，说明请求头没有到达服务器。

已经在第 1 步安装了插件？ 那么你的服务器是内置的无密钥版本，所以无论你请求什么，SVG 都会保持锁定状态。添加上面的带密钥服务器即可：两者并行运行，PNG 工具会出现两次，你可以在客户端中禁用无密钥的那个。

第 3 步：将图标引入你的项目

提出你的需求。如果你心里有具体的风格就直接说出名字；如果没有，可以先要求查看几种风格：PNG 预览免费且无需密钥，因此对比不花任何成本。

• “以 PNG 预览形式给我展示六种不同 Icons8 风格的设置图标，并告诉我每种风格的名称。”
• “构建一个设置界面。图标使用 Icons8、Material Outlined，24px。”
• “将该项目中的所有图标替换为 Flat Color，保持当前尺寸不变。”
• “为落地页上的六个功能区块添加图标，统一风格，48px。”

描述视觉效果也可以：“细轮廓、无颜色、24px”、“适合落地页的扁平彩色”、“手绘风格”。技能会将你的代理选择的风格保存到 icons8.json，后续会话会自动保持。全部 130 种风格可在 icons8.com/icons 浏览。

提示词中值得包含的三件事

• 风格。 只需指定一次，技能就会将整个项目的风格锁定在 icons8.json 中。ID 是风格专属的，因此之后更换风格意味着需要重新选择每个图标。
• 尺寸。 每种风格都是为一个尺寸设计的，从 16px 的字形到 64px 的彩色场景。询问你的代理所选风格是为哪个尺寸设计的，然后使用该尺寸或其两倍。一个 50px 的图标缩小到 16px 会丢失使其可读的细节。
• 格式。 PNG 预览免费且即时，因此可以先在预览上迭代，等图标集定稿后再要求 SVG。SVG 需要密钥，参见第 2 步。

下面是同一个界面的两次构建：左边没有指定风格，所以代理对每个标签都取了第一个搜索结果。右边为整个界面指定了一种风格。

未指定风格

图标来自四种不同风格：设置用品牌 Logo、单色侧边栏中放全彩头像、状态用表情符号。

Material Outlined，24px

18 个图标，统一描边粗细，统一外观。每个图标都跟随文字颜色，因此深色模式和主题化免费获得。

查看实时演示获取灵感。如果有无法运行的情况，请参阅常见问题。

常见问题

提示“No API key”怎么办？

订阅 $15，在 Icons8 账户的 MCP 标签页中找到设置代码。或者从 Icons8 开发者门户获取 API 密钥。

如何在整个项目中保持一种图标风格？

第 1 步中的 icons8 技能会帮你完成：它会为整个项目选择一个图标包并锁定在 icons8.json 中。提交该文件后，下一次会话或其他代理会保持相同风格。没有该技能时，请在第一个提示词中指定风格，并在之后添加图标时重复指定。ID 是风格专属的：同一个图标在不同风格中具有不同的 ID，因此之后更换风格意味着需要重新选择每个图标。

我可以获得哪些格式？

SVG（需要 API 密钥），PNG 预览对所有用户开放。

我可以通过 MCP 服务器免费下载 PNG 图标吗？

可以，当你连接到 Icons8 MCP 服务器时，无需 API 密钥即可获得 PNG 图标预览。

免费版本的许可条款是什么？

通过 MCP 下载的所有 PNG 图标均可免费使用，包括在生产环境中，前提是你提供指向我们的链接。请在此处查看我们的许可证。对于需要在生产界面中缩放的元素，请使用带 API 密钥的 SVG。

这是开源的吗？

技能和插件在 GitHub 上采用 Apache-2.0 许可，skills.sh 列表通过了 Socket、Snyk 和 Gen Agent Trust Hub 安全审计。图标本身单独授权：免费版需注明出处，SVG 属于付费计划。

我需要 API 密钥吗？

PNG 无需密钥即可使用，SVG 下载需要付费 API 密钥，可在账户的 MCP 标签页中找到。

我请求的是 SVG 但仍然得到 PNG

运行 claude mcp list 并统计工具数量。如果只有四个，说明密钥没有到达服务器，请检查配置中的 Authorization 请求头，或者从 MCP 标签页复制现成的配置。如果是五个工具但仍然得到 PNG：在提示词中明确指定格式；如果你安装了插件，请确认代理使用的是带密钥的服务器，而不是内置的无密钥版本。

我应该请求什么图标尺寸？

使用该风格的设计尺寸：Simple Small 为 16px、Material 和 Windows 11 为 24px、iOS 为 30 至 50px、彩色风格为 48px 及以上。大尺寸风格用作小尺寸时会丢失细节。你的代理可以告诉你任何风格的设计尺寸。

我可以批量下载图标吗？

暂时不行，但这正是我们目前正在积极开发的功能。

它兼容 OpenAI Codex 吗？

兼容。运行 codex mcp add icons8mcp --url https://mcp.icons8.com/mcp/，然后使用 npx skills add icons8/agent-skills --skill icons8 添加技能。对于 SVG，使用 --bearer-token-env-var 将 Codex 指向你的密钥，参见第 2 步。

需要帮助？

查看我们的文档或与我们在线聊天。