MCP Server Remix Icon

🚀 Remix 圖標 MCP

一個強大的圖標搜索和推薦服務，基於 Cloudflare Workers 構建，藉助先進的語義匹配算法，為用戶提供智能的圖標發現功能。

🚀 快速開始

該項目使用 TypeScript 和 Cloudflare Workers 構建。主要功能在 RemixIconMCP 類中實現，該類繼承自 WorkerEntrypoint。以下是項目的設置與部署步驟：

# 安裝依賴
npm install

# 運行開發服務器
npm run dev

# 部署到 Cloudflare Workers
npm run deploy

# 運行測試
npm run test

✨ 主要特性

• 智能圖標搜索：依據自然語言描述查找圖標，運用多種相似性算法。
• 多語言支持：對英語和中文文本輸入的支持進行了優化。
• 分類管理：可按類別瀏覽和搜索圖標。
• 高級匹配：通過多種算法實現更優的搜索結果，包括 Jaccard 相似度、N - gram 匹配、分類匹配、精確匹配、Levenshtein 距離、名稱匹配、標籤基於匹配。
• 倒排索引：利用倒排索引實現快速初步搜索。
• 緩存：採用 LRU 緩存策略提升性能。

📚 詳細文檔

📄 API 接口

搜索圖標

findIcons(description: string): ResponseContent[]

根據用戶描述查找圖標，返回前 5 個推薦結果及相似度評分。

獲取圖標分類

getIconCategories(): ResponseContent[]

返回所有可用的圖標分類列表。

按分類搜索圖標

findIconsByCategory(description: string, category: string): ResponseContent[]

在特定分類內根據描述查找圖標，返回前 5 個推薦結果。

📁 項目結構

.
├── src/                   # 源代碼目錄
│   ├── index.ts           # 入口文件
│   ├── data/              # 數據文件包括圖標目錄
│   ├── domain/            # 域模型和服務
│   │   ├── icon/          # 圖標域模型
│   │   └── search/        # 搜索功能模塊
│   ├── infrastructure/    # 基礎設施組件
│   │   ├── logging/       # 日誌工具
│   │   └── result/        # 結果處理
│   └── utils/             # 工具函數
│       ├── similarity/    # 相似度計算算法
│       └── text/          # 文本處理工具
├── tests/                 # 測試文件
│   ├── integration/       # 集成測試
│   └── unit/              # 單元測試
└── wrangler.jsonc         # Cloudflare Workers配置文件

📋 響應格式

所有接口返回響應採用以下格式：

interface ResponseContent {
    type: 'text';
    text: string;
}

🔧 技術細節

• 基於 Cloudflare Workers 平臺構建。
• 使用 LRU 緩存策略進行性能優化。
• 實現加權多算法相似度評分。
• 支持中英文文本的字符和單詞級匹配。
• 可配置相似度閾值和權重。
• 使用倒排索引實現快速初步搜索。

⚙️ 性能優化

• 採用 LRU（最近最少使用）緩存策略，最大緩存大小為 2000 條目。
• 最低分數閾值為 0.08。
• 對中英文文本進行優化的相似度計算。
• 採用兩級搜索策略：先通過倒排索引獲取快速初步結果，隨後進行詳細評分。

📄 許可證

MIT License