图标管理工具

用于搜索、下载和管理来自中国最大图标库Iconfont的图标,支持多种图标类型和项目列表管理。

  • by GuoChen-thlg
  • TypeScript
  • 本地部署
  • 2 星标
  • 更新于
在 GitHub 查看 GuoChen-thlg/iconfont-mcp

使用说明

图标字体mcp

Iconfont的MCP服务器(Iconfont.cn)-从中国最大的图标库中搜索、下载和管理图标。

特征

  • 搜索图标:按名称搜索图标,并使用图标类型过滤器(线条、填充、平面、手绘等)
  • 下载SVG:下载图标SVG数据并保存到文件
  • 列出项目:列出您的Iconfont项目(需要身份验证)

安装

全局安装

npm install guochen-thlg/icon-font-mcp -g

使用npx运行

npx -y guochen-thlg/iconfont-mcp

本地运行

克隆仓库并直接运行:

git clone https://github.com/GuoChen-thlg/iconfont-mcp.git
cd iconfont-mcp
pnpm install && pnpm build
node dist/index.js

MCP配置

克劳德桌面版

添加到您的 claude_desktop_config.json:

{
  "mcpServers": {
    "iconfont": {
      "command": "npx",
      "args": ["-y", "guochen-thlg/iconfont-mcp"]
    }
  }
}

通过身份验证

对于需要身份验证的功能(如列出项目),请设置 ICONFONT_COOKIE 环境变量:

export ICONFONT_COOKIE="your-iconfont-cookie"

要获取cookie,请执行以下操作:

  1. 登录https://www.iconfont.cn/
  2. 打开浏览器DevTools(F12)
  3. 转到应用程序/存储→ 饼干
  4. 复制 EGG_SESS_ICONFONT cookie值

可用工具

图标搜索图标

在Iconfont库中搜索图标。

参数:

  • query (字符串,必填):搜索图标名称查询
  • icon_type (字符串,可选):图标样式类型-“”(全部)、“线条”、“填充”、“平面”、“手”、“简单”、“复杂”
  • page (数字,可选):页码(默认值:1)
  • page_size (数字,可选):每页最多100个结果(默认值:54)
  • response_format (字符串,可选):“markdown”或“json”(默认值:markdown)

iconfont_download_icon

下载特定图标的SVG数据。

参数:

  • icon_id (字符串,必填):搜索结果中的图标ID
  • project_id (字符串,可选):私有项目中图标的项目ID
  • output_path (字符串,可选):保存SVG文件的目录
  • filename (字符串,可选):不带扩展名的文件名
  • response_format (字符串,可选):“markdown”或“json”(默认值:markdown)

iconnfont_list_项目

列出您的Iconfont项目(需要身份验证)。

参数:

  • cookie (字符串,可选):Iconfont cookie覆盖
  • response_format (字符串,可选):“markdown”或“json”(默认值:markdown)

iconfont_login

通过提供cookie登录Iconfont。

参数:

  • cookie (string,必填): EGG_SESS_ICONFONT cookie值

iconfont_auto_login

通过打开浏览器进行手动身份验证自动登录。

参数: 无(自动打开浏览器窗口)

iconfont_check_login

检查您当前是否使用有效的cookie登录。

参数: 无

iconnfont_get_project_detail

获取特定项目的详细信息。

参数:

  • pid (字符串,必填):项目ID
  • cookie (字符串,可选):Iconfont cookie覆盖
  • response_format (字符串,可选):“markdown”或“json”(默认值:markdown)

iconfont_project_search_icons

在特定项目中搜索图标。

参数:

  • pid (字符串,必填):项目ID
  • keyword (字符串,必填):搜索关键字
  • cookie (字符串,可选):Iconfont cookie覆盖
  • page (数字,可选):页码(默认值:1)
  • response_format (字符串,可选):“markdown”或“json”(默认值:markdown)

发展

# Install dependencies
pnpm install

# Build
pnpm run build

# Run in development mode
pnpm run dev

许可证

麻省理工学院