# 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

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

### Run with npx

```bash
npx -y guochen-thlg/iconfont-mcp
```

### Local run

Clone the repo and run directly:

```bash
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`:

```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:

```bash
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

```bash
# Install dependencies
pnpm install

# Build
pnpm run build

# Run in development mode
pnpm run dev
```

## License

MIT