icon-font-mcp

MCP server for Iconfont (iconfont.cn) - Search, download, and manage icons from China's largest icon library.

Features

• Search Icons: Search for icons by name with filters for icon types (line, fill, flat, hand-drawn, etc.)

• Download SVG: Download icon SVG data and save to files

• List Projects: List your Iconfont projects (requires authentication)

Installation

Global install

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

Run with npx

npx -y guochen-thlg/iconfont-mcp

Local run

Clone the repo and run directly:

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

MCP Configuration

Claude Desktop

Add to your claude_desktop_config.json:

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

With Authentication

For features requiring authentication (like listing projects), set the ICONFONT_COOKIE environment variable:

export ICONFONT_COOKIE="your-iconfont-cookie"

To get the cookie:

1. Log in to https://www.iconfont.cn/

2. Open browser DevTools (F12)

3. Go to Application/Storage → Cookies

4. Copy the EGG_SESS_ICONFONT cookie value

Available Tools

iconfont_search_icons

Search for icons in the Iconfont library.

Parameters:

• query (string, required): Search query for icon name

• icon_type (string, optional): Icon style type - '' (all), 'line', 'fill', 'flat', 'hand', 'simple', 'complex'

• page (number, optional): Page number (default: 1)

• page_size (number, optional): Results per page, max 100 (default: 54)

• response_format (string, optional): 'markdown' or 'json' (default: markdown)

iconfont_download_icon

Download SVG data for a specific icon.

Parameters:

• icon_id (string, required): Icon ID from search results

• project_id (string, optional): Project ID for icons in private projects

• output_path (string, optional): Directory to save SVG file

• filename (string, optional): Filename without extension

• response_format (string, optional): 'markdown' or 'json' (default: markdown)

iconfont_list_projects

List your Iconfont projects (requires authentication).

Parameters:

• cookie (string, optional): Iconfont cookie override

• response_format (string, optional): 'markdown' or 'json' (default: markdown)

iconfont_login

Login to Iconfont by providing a cookie.

Parameters:

• cookie (string, required): The EGG_SESS_ICONFONT cookie value

iconfont_auto_login

Auto login by opening a browser for manual authentication.

Parameters: None (opens a browser window automatically)

iconfont_check_login

Check if you are currently logged in with a valid cookie.

Parameters: None

iconfont_get_project_detail

Get detailed info about a specific project.

Parameters:

• pid (string, required): Project ID

• cookie (string, optional): Iconfont cookie override

• response_format (string, optional): 'markdown' or 'json' (default: markdown)

iconfont_project_search_icons

Search icons within a specific project.

Parameters:

• pid (string, required): Project ID

• keyword (string, required): Search keyword

• cookie (string, optional): Iconfont cookie override

• page (number, optional): Page number (default: 1)

• response_format (string, optional): 'markdown' or 'json' (default: markdown)

Development

# Install dependencies
pnpm install

# Build
pnpm run build

# Run in development mode
pnpm run dev

License

MIT