🚀 Hugeicons MCP 服务器

Hugeicons MCP 服务器是一个基于 TypeScript 的服务器，它实现了模型上下文协议（MCP），主要用于集成和管理 Hugeicons。借助该服务器提供的工具和资源，开发者能够在各类平台上轻松集成 Hugeicons，同时 AI 助手也能为使用 Hugeicons 提供精准的指导。

🚀 快速开始

您可以直接使用 npx 运行服务器：

npx @hugeicons/mcp-server

✨ 主要特性

工具

• list_icons：获取所有可用的 Hugeicons 图标列表。
• search_icons：按名称或标签搜索图标。
• get_platform_usage：获取特定平台上的 Hugeicons 使用说明。

资源

• 平台文档（Markdown 格式）：
  • hugeicons://docs/platforms/react：React 集成指南。
  • hugeicons://docs/platforms/vue：Vue 集成指南。
  • hugeicons://docs/platforms/angular：Angular 集成指南。
  • hugeicons://docs/platforms/svelte：Svelte 集成指南。
  • hugeicons://docs/platforms/react-native：React Native 集成指南。
  • hugeicons://docs/platforms/flutter：Flutter 集成指南。
• 图标数据：
  • hugeicons://icons/index：所有 Hugeicons 的完整索引（JSON 格式）。

功能

该服务器提供全面的 Hugeicons 集成支持，涵盖以下方面：

• 图标发现和搜索。
• 平台特定安装指南。
• 使用示例代码片段。
• 组件属性文档。
• 包安装说明。

📦 安装指南

要与 Claude Desktop 一起使用，请添加服务器配置：

• 在 MacOS 上：~/Library/Application Support/Claude/claude_desktop_config.json
• 在 Windows 上：%APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "hugeicons": {
      "command": "npx",
      "args": [
        "-y",
        "@hugeicons/mcp-server"
      ]
    }
  }
}

args 数组指定：

1. -y：自动回答“是”以解决 npx 提示。
2. 包名：@hugeicons/mcp-server。

🔧 技术细节

开发

安装依赖项

npm install

构建服务器

npm run build

带自动重建的开发

npm run watch

调试

由于 MCP 服务器通过 stdio 通信，调试可能具有挑战性。我们推荐使用 MCP Inspector，它作为包脚本可用：

npm run inspector

Inspector 将提供一个 URL，以便您在浏览器中访问调试工具。