MCP Server Remix Icon

🚀 Remix Icon MCP

A powerful icon search and recommendation service built on Cloudflare Workers, offering intelligent icon discovery through advanced semantic matching algorithms.

🚀 Quick Start

Remix Icon MCP is a robust icon search and recommendation service. It is built on Cloudflare Workers and uses advanced semantic matching algorithms to provide intelligent icon discovery capabilities.

✨ Features

• Intelligent Icon Search: Find icons based on natural language descriptions using multiple similarity algorithms.
• Multilingual Support: Optimized for English and Chinese text input.
• Categorized Management: Browse and search icons by category.
• Advanced Matching: Achieve better search results through multiple algorithms, including Jaccard similarity, N - gram matching, category matching, exact matching, Levenshtein distance, name matching, and tag - based matching.
• Inverted Index: Use an inverted index for fast initial searches.
• Caching: Employ an LRU caching strategy to improve performance.

💻 Usage Examples

Search Icons

findIcons(description: string): ResponseContent[]

This API finds icons based on the user's description and returns the top 5 recommended results along with similarity scores.

Get Icon Categories

getIconCategories(): ResponseContent[]

This API returns a list of all available icon categories.

Search Icons by Category

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

This API finds icons based on the description within a specific category and returns the top 5 recommended results.

📚 Documentation

Project Structure

.
├── src/                   # Source code directory
│   ├── index.ts           # Entry file
│   ├── data/              # Data files including icon directories
│   ├── domain/            # Domain models and services
│   │   ├── icon/          # Icon domain model
│   │   └── search/        # Search function module
│   ├── infrastructure/    # Infrastructure components
│   │   ├── logging/       # Logging tools
│   │   └── result/        # Result handling
│   └── utils/             # Utility functions
│       ├── similarity/    # Similarity calculation algorithms
│       └── text/          # Text processing tools
├── tests/                 # Test files
│   ├── integration/       # Integration tests
│   └── unit/              # Unit tests
└── wrangler.jsonc         # Cloudflare Workers configuration file

🔧 Technical Details

• Built on the Cloudflare Workers platform.
• Use an LRU caching strategy for performance optimization.
• Implement weighted multi - algorithm similarity scoring.
• Support character and word - level matching for both English and Chinese texts.
• Allow configurable similarity thresholds and weights.
• Use an inverted index for fast initial searches.

Performance Optimization

• Adopt an LRU (Least Recently Used) caching strategy with a maximum cache size of 2000 entries.
• Set a minimum score threshold of 0.08.
• Optimize similarity calculations for English and Chinese texts.
• Employ a two - level search strategy: fast initial results from the inverted index, followed by detailed scoring.

Response Format

All API interfaces return responses in the following format:

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

Development

This project is built using TypeScript and Cloudflare Workers. The main functionality is implemented in the RemixIconMCP class, which inherits from WorkerEntrypoint.

Setup and Deployment

# Install dependencies
npm install

# Run the development server
npm run dev

# Deploy to Cloudflare Workers
npm run deploy

# Run tests
npm run test

📄 License

MIT License