Metadata-Version: 2.4
Name: yooztech_mcp_fontawesome_icons
Version: 0.0.1
Summary: MCP server: Font Awesome 6 free icons search and PNG export
Author: yooztech
License: MIT
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: mcp>=1.2.0
Requires-Dist: cairosvg>=2.7.0
Dynamic: license-file

# yooztech_mcp_fontawesome_icons —— Font Awesome 图标 MCP 工具

基于 MCP (Model Context Protocol) 的 Font Awesome 6 免费版图标能力：按关键词搜索图标，并将内嵌 SVG 渲染为 PNG（对应原 `skills/fontawesome-icons` 技能，不依赖 Node/OpenClaw）。

## 功能概述

- `fontawesome_search_icons(query, max_results)`：按名称 / 标签 / 搜索词查找图标
- `fontawesome_export_png(icon_name, size, style, output_path)`：导出单个图标为 PNG
- `fontawesome_search_and_export(query, size, max_results, output_dir)`：搜索并对每条结果导出 PNG（接近原 skill 的「搜索 + 出图」流程）

数据来源：随包附带 `icons.json`（与技能中 `assets/mappings/icons.json` 同源），PNG 由内嵌 SVG 生成，**无需**再打包数千个独立 SVG 文件。

## 在 Cursor 中配置

```json
{
  "mcpServers": {
    "yooztech_mcp_fontawesome_icons": {
      "command": "yooztech_mcp_fontawesome_icons",
      "args": []
    }
  }
}
```

或使用 `uvx`（需已发布或可本地路径安装）。

## 系统依赖（PNG 渲染）

- **推荐**：`cairosvg`（已写在 `pyproject.toml`）+ 系统 **libcairo**  
  - Debian/Ubuntu：`sudo apt-get install -y libcairo2-dev`  
  - macOS（Homebrew）：`brew install cairo`
- **备选**：已安装 ImageMagick，且 `convert` 命令可用时，会作为回退路径。

## 开发安装

```bash
cd mcp_fontawesome_icons
pip install -e .
yooztech_mcp_fontawesome_icons
```

## 许可证

- 本 MCP 代码：MIT（见 `LICENSE`）
- Font Awesome 免费资源请遵循 [Font Awesome Free License](https://fontawesome.com/license/free)
