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 中配置

{
  "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 命令可用时，会作为回退路径。

开发安装

cd mcp_fontawesome_icons
pip install -e .
yooztech_mcp_fontawesome_icons

许可证

• 本 MCP 代码：MIT（见 LICENSE）
• Font Awesome 免费资源请遵循 Font Awesome Free License