iconfont-mcp

Search for icons in the Iconfont icon library (iconfont.cn).

This tool searches the Iconfont database for icons matching the specified query. It provides access to millions of icons from various designers and collections.

Args:

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

• icon_type (string, optional): Icon style type - '' for all, 'line' for outline, 'fill' for filled, 'flat' for flat, 'hand' for hand-drawn, 'simple' for simple, 'complex' for elaborate (default: all)

• page (number, optional): Page number for pagination, starting from 1 (default: 1)

• page_size (number, optional): Number of results per page, max 100 (default: 54)

• response_format ('markdown' | 'json', optional): Output format (default: markdown)

Returns: For JSON format: { total: number, page: number, page_size: number, icons: [...] } For markdown: Human-readable list with icon names and IDs

Examples:

• Use when: "Find home icons" -> query="home"

• Use when: "Search outline-style arrows" -> query="arrow", icon_type="line"

• Use when: "Get page 2 of search results" -> query="user", page=2

Download SVG data for a specific icon from Iconfont.

This tool retrieves the SVG content for an icon and optionally saves it to a file. The icon_id can be obtained from the search results.

Args:

• icon_id (string, required): The icon ID to download (from search results)

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

• filename (string, optional): Filename for the downloaded SVG (without extension)

Returns: For JSON format: { icon_id: string, name: string, svg: string, saved_to: string | null } For markdown: Confirmation message with file path if saved

Examples:

• Use when: "Download the home icon" -> icon_id from search results

• Use when: "Save to specific folder" -> output_path="./src/icons"

List all projects in the user's Iconfont account.

This tool requires authentication via Iconfont cookie. It returns all projects that the user has created or has access to.

Args:

• cookie (string, optional): The EGG_SESS_ICONFONT cookie from iconfont.cn. Can be used instead of setting environment variable.

• response_format ('markdown' | 'json', optional): Output format (default: markdown)

Returns: For JSON format: { projects: [{ id, name, icon_count, updated_at }] } For markdown: Human-readable list of projects

Note: Requires authentication. Can provide cookie via args, ICONFONT_COOKIE environment variable, or iconfont_login tool. Cookie can be obtained from browser dev tools after logging into iconfont.cn.

Examples:

• Use when: "See all my icon projects"

• Use when: "Find project ID for a specific project"

Authenticate with Iconfont using browser cookie.

This tool allows you to login to your Iconfont account to access private projects and features that require authentication.

Args:

• cookie (string, required): The EGG_SESS_ICONFONT cookie value from iconfont.cn

How to get the cookie:

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

2. Open browser DevTools (F12)

3. Go to Application/Storage → Cookies → https://www.iconfont.cn

4. Copy the value of "EGG_SESS_ICONFONT" cookie

Returns:

• Success or error message

Note: The cookie is stored in memory only and will be lost when the server restarts. For persistent login, set ICONFONT_COOKIE environment variable instead.

Examples:

• Use when: "Login to access my private projects"

Automatically open browser to log in to Iconfont and obtain authentication cookie.

This tool will:

1. Try to open browser using Puppeteer

2. If Puppeteer fails, use system command to open browser

3. Let you log in manually in the browser

4. Automatically detect when login is successful

5. Store the authentication cookie for future API calls

Returns:

• Success message with login status

Note: This opens a real browser for secure login. The browser will close automatically after login. This tool may take longer to complete as it waits for manual login.

Examples:

• Use when: "I want to log in without manually copying cookie"

Check if currently logged in to Iconfont.

Returns:

• Current login status and whether a cookie is available

Get detailed information about a specific Iconfont project.

This tool retrieves project details including name, icon count, font family, etc. Results are cached for 5 minutes based on the project's update time to reduce API calls.

Args:

• cookie (string, optional): The EGG_SESS_ICONFONT cookie from iconfont.cn. Can be used instead of setting environment variable.

• pid (string, required): Project ID (can be obtained from iconfont_list_projects)

• response_format ('markdown' | 'json', optional): Output format (default: markdown)

Returns: Project details including id, name, icon_count, font_family, created_at, updated_at

Examples:

• Use when: "Get details of project 1997925" -> pid="1997925"

Search for icons within a specific Iconfont project using keyword.

This tool searches icons inside a specific project that the user has access to. Requires authentication via Iconfont cookie.

Args:

• cookie (string, optional): The EGG_SESS_ICONFONT cookie from iconfont.cn. Can be used instead of setting environment variable.

• pid (string, required): Project ID (can be obtained from iconfont_list_projects)

• keyword (string, required): Keyword to search for icons within the project

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

• response_format ('markdown' | 'json', optional): Output format (default: markdown)

Returns: For JSON format: { total: number, page: number, icons: [...] } For markdown: Human-readable list with icon names and IDs

Note: Requires authentication. Can provide cookie via args, ICONFONT_COOKIE environment variable, or iconfont_login tool.

Examples:

• Use when: "Search copy icons in project 1997925" -> pid="1997925", keyword="copy"

• Use when: "Search text formatting icons in my project" -> pid="123456", keyword="text"