Remix 图标 MCP

English | 简体中文

一个强大的图标搜索和推荐服务，基于Cloudflare Workers构建，通过先进的语义匹配算法提供智能的图标发现功能。

功能

• 智能图标搜索：根据自然语言描述查找图标，使用多种相似性算法
• 多语言支持：优化了对英语和中文文本输入的支持
• 分类管理：按类别浏览和搜索图标
• 高级匹配：通过多种算法实现更优的搜索结果：
  • 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配置文件

技术细节

• 基于Cloudflare Workers平台构建
• 使用LRU缓存策略进行性能优化
• 实现加权多算法相似度评分
• 支持中英文文本的字符和单词级匹配
• 可配置相似度阈值和权重
• 使用倒排索引实现快速初步搜索

性能优化

• 采用LRU（最近最少使用）缓存策略，最大缓存大小：2000条目
• 最低分数阈值：0.08
• 对中英文文本进行优化的相似度计算
• 两级搜索策略：倒排索引快速初步结果，随后详细评分

响应格式

所有接口返回响应采用以下格式：

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

开发

该项目使用TypeScript和Cloudflare Workers构建。主要功能在RemixIconMCP类中实现，该类继承自WorkerEntrypoint。

设置与部署

# 安装依赖
npm install

# 运行开发服务器
npm run dev

# 部署到Cloudflare Workers
npm run deploy

# 运行测试
npm run test

许可证

MIT License