关于 Keyline Icons
Keyline Icons 是供 Agent 查询图标并获取 SVG 或 React 用法的离线 MCP 服务。图标集随包提供,无需 API 密钥或网络连接。
主要功能
- 01查看图标集与样式说明
- 02按名称搜索图标
- 03按样式获取 SVG
- 04获取 React 导入语句与 JSX
适用场景
- 01查找准确的图标名称
- 02检查图标的 SVG 源码
- 03在 React 项目中添加图标
MCP 相关
向 MCP 客户端提供描述和搜索图标集、获取 SVG 源码及 React 用法的工具。
配置
本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。
工具
4收录的工具列表 · 更新于 3 天前
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| limit | integer | 否 | 结果上限。默认值为 25。 |
| query | string | 是 | 要匹配的子字符串,例如 `arrow` 或 `mail`。 |
| style | enum | 否 | 仅返回具有此样式的图标。stroke | two-tone | duotone | fill |
详细介绍
@keyline-icons/mcp
适用于 Keyline Icons 的 MCP 服务。让 Agent 搜索图标集、读取图标的 SVG,并获取正确的 React 导入语句,无需猜测名称。
安装
Claude Code:
claude mcp add keyline-icons -- npx -y @keyline-icons/mcp
其他任何通过 stdio 使用 MCP 的工具:
{
"mcpServers": {
"keyline-icons": {
"command": "npx",
"args": ["-y", "@keyline-icons/mcp"]
}
}
}
无需 API 密钥,也无需联网。整个图标集都随软件包一起提供。
工具
| 工具 | 功能 |
|---|---|
describe_set | 统计数量、样式,以及决定各图标使用何种样式的规则。建议优先调用。 |
search_icons | 按名称查找图标。返回每个图标具有的样式。 |
get_icon | 返回指定名称、样式和边角处理方式(regular 或 sharp)图标的完整 SVG 源码。 |
get_react_usage | 返回来自 @keyline-icons/react 的导入语句和 JSX,包括 sharp 入口点。 |
工具的设计缘由
名称可以推测,但并不直观。 复合名称以基础词开头,因此带勾选标记的邮件图标名为 mail-check,而不是 check-mail;容器则作为前缀:square-arrow-down。search_icons 按完全匹配、前缀匹配、词边界匹配、子串匹配的顺序排序,因此搜索 check 时,check 会排在包含它的 12 个复合名称之前。
缺少某种样式本身就是有效答案,不是错误。 bar-chart 由 3 条开放线段组成,没有内部区域,因此没有填充样式。工具会明确说明这一点,而不是不返回结果。双色调和填充样式需要可填充区域,该区域来自字形自身的封闭空间或方形/圆形容器。
拼写错误可在一次交互中纠正。 对于未匹配的名称,工具会依次按子串、编辑距离、开头部分进行匹配。因此,chekc 会建议 check,arow 会建议 arrow-* 系列,尽管没有单独的 arrow 图标。
自定义图标
需要图标集中没有、为自己的产品绘制的图标? 自定义图标集 使用相同的网格绘制,并以 SVG、Figma 文件和 React 软件包的形式交付。
许可证
MIT。
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。