Iconfont

MCP server that enables searching, downloading, and managing Iconfont icons via MCP clients.

javascript

0

GitHub Stars

javascript

Language

4 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "guochen-thlg-iconfont-mcp": {
      "command": "npx",
      "args": [
        "@thlg/icon-font-mcp"
      ],
      "env": {
        "ICONFONT_COOKIE": "YOUR_COOKIE"
      }
    }
  }
}

You can use this MCP server to interact with Iconfont’s icon library by searching icons, downloading SVG data, and listing your Iconfont projects. This server exposes practical actions you can perform through an MCP client, enabling you to work with Iconfont data from within your existing MCP workflow.

How to use

To use the Iconfont MCP server, run it through your MCP client. The server provides three main capabilities: search for icons by name and style, download the SVG data for a chosen icon, and list your Iconfont projects (the last one requires authentication). You can connect via a local, standard input/output (stdio) MCP configuration that launches the server using a command like npx.

You will typically perform authentication by supplying your Iconfont cookie when you need to list projects. This cookie authenticates your session for actions that require access to your private Iconfont data.

How to install

Prerequisites: Node.js and npm must be available on your system.

Install the Iconfont MCP server globally so you can run it from any shell.

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

Alternatively, you can run the server directly with npx without a local installation.

npx @thlg/icon-font-mcp

Configure the MCP client to use the Iconfont MCP server. If you are using Claude Desktop, add the following to your claude_desktop_config.json under mcpServers with the iconfont key.

{  "mcpServers": {
  "iconfont": {
    "command": "npx",
    "args": ["@thlg/icon-font-mcp"]
  }
}}

Configuration and authentication notes

For operations that require authentication, such as listing your Iconfont projects, set an environment variable that holds your Iconfont cookie.

Example: export ICONFONT_COOKIE="your-iconfont-cookie".

To obtain the cookie from Iconfont, log in to the Iconfont site and copy the EGGS_SESS_ICONFONT cookie from your browser's storage.

Available tools

iconfont_search_icons

Search for icons within Iconfont by name and optional style filters. Supports pagination and returns results in the selected format.

iconfont_download_icon

Download the SVG data for a specific icon by its ID and save it to a file if an output path is provided.

iconfont_list_projects

List your Iconfont projects. This tool requires authentication via the ICONFONT_COOKIE environment variable.