Release v1.1.0

What's Changed

🚀 Features

• Simplified Search Response: Streamlined icon search results to return only icon names for cleaner output
• Search Scoring: Added relevance scores to search results for better icon selection
• Optimized Output Format: Enhanced search result formatting with improved scoring algorithm

📝 Documentation

• Tool Description Update: Added return format example to tool description for better user guidance

🔧 Maintenance

• Version Bump: Updated to v1.1.0

Usage

The icon search tool now returns simplified results:

icon-name-1 (score 95.00)
icon-name-2 (score 87.50)
icon-name-3 (score 76.20)

This makes it easier to quickly identify the most relevant icons for your needs.

Full Changelog: v1.0.0...v1.1.0

Release v1.0.1 - Hotfix

Release v1.0.1 - Hotfix

This hotfix release addresses critical issues with package publishing and documentation:

🐛 Fixes

• Package Publishing: Fixed MCP server name from remix-icon to remixicon for npm publishing compatibility
• Documentation Updates: Completely updated documentation to reflect CLI-based MCP server architecture
• Platform Setup: Added comprehensive setup instructions for Claude Desktop, Claude Code, and Codex
• Architecture References: Removed outdated Cloudflare Workers references and replaced with Node.js CLI implementation

📋 Changes

• Updated all documentation files (README.md, README.zh-CN.md, CLAUDE.md)
• Corrected package name casing to allow successful npm publication
• Enhanced platform-specific setup instructions
• Improved changelog with proper versioning

🚀 Installation

Claude Desktop

claude mcp add --transport stdio remixicon -- npx -y remixicon-mcp

Claude Code

/plugin marketplace add Remix-Design/remixicon-mcp

Codex

codex mcp add remixicon -- npx -y remixicon-mcp

📚 Documentation

For detailed setup instructions and usage examples, see the README.md.

---

Full Changelog: v0.4.0...v1.0.1

🎉 RemixIcon MCP v1.0.0: Production-Ready Icon Search Server

RemixIcon MCP v1.0.0

🚀 Production-ready Model Context Protocol server for intelligent Remix Icon search and discovery

Overview

RemixIcon MCP is a high-performance, lightweight Model Context Protocol (MCP) server that provides intelligent icon search capabilities for the entire Remix Icon library. This server enables AI assistants like Claude to find and recommend perfect icons based on semantic keywords, categories, and usage patterns.

Key Features

• 🔍 Smart Semantic Search: Advanced keyword-based search with FlexSearch-powered indexing
• 🎯 Focused Results: Always returns top 5 most relevant icons for clear decision-making
• 🏗️ Clean Architecture: Domain-driven design with separated concerns for maintainability
• ⚡ High Performance: Local indexing with sub-millisecond search response times
• 🔧 AI-Optimized: Designed specifically for LLM integration with structured responses
• 🛠️ Developer Ready: CLI tool, MCP server, and marketplace plugin in one package

Architecture & Design

Clean Architecture Principles

• Domain Layer: Core business entities and validation rules
• Application Layer: Use cases orchestrating search workflows
• Infrastructure Layer: Search implementation and data persistence
• Interface Layer: MCP protocol handling and CLI interface

Search Technology

• FlexSearch Integration: High-performance document indexing with configurable field weights
• Keyword Intelligence: Unicode-aware parsing supporting up to 20 targeted keywords
• Semantic Matching: Advanced token matching across icon names, categories, and usage contexts
• Deterministic Scoring: Consistent, predictable relevance ranking

What's New in v1.0.0

✨ Major Features

• Production MCP Server: Full Model Context Protocol implementation with stdio communication
• Intelligent Search Engine: FlexSearch-powered indexing with configurable field weights
• CLI Tool: Standalone execution via npx remixicon-mcp or global installation
• Clean Architecture: Domain-driven design with comprehensive test coverage
• Marketplace Integration: Claude Code plugin with automatic installation and updates

🔧 Technical Improvements

• TypeScript Integration: Full type safety with strict TypeScript configuration
• Modern Tooling: Biome for formatting, Vitest for testing, pnpm for package management
• Unicode Support: International keyword parsing with proper boundary detection
• Error Handling: Comprehensive validation and user-friendly error messages
• Performance Optimization: Efficient indexing and search algorithms

📦 Package Features

• NPM Distribution: Easy installation and global CLI availability
• Binary Support: Executable CLI via bin/run.cjs for direct execution
• Marketplace Plugin: Claude Code integration with rich metadata
• Documentation: Comprehensive README with setup guides for all platforms

Use Cases

For AI Assistants

• Icon Recommendation: Suggest perfect icons based on user requirements
• Design Workflow: Integrate icon search into UI/UX design processes
• Development Assistance: Help developers find appropriate icons for interfaces
• Content Creation: Support icon selection for documentation and presentations

For Developers

• CLI Integration: Command-line icon search for development workflows
• Build Tools: Integrate into asset pipelines and documentation generators
• IDE Plugins: Build editor extensions with icon search capabilities
• Automation: Scriptable icon search for batch processes

Installation & Setup

NPM Installation

# Global installation for CLI usage
npm install -g remixicon-mcp

# Direct execution without installation
npx remixicon-mcp

# Development installation
pnpm install && pnpm test

Claude Desktop Integration

{
  "mcpServers": {
    "remix-icon": {
      "command": "npx",
      "args": ["-y", "remixicon-mcp"]
    }
  }
}

Claude Code Plugin

# Install from marketplace
/plugin marketplace add Remix-Design/remixicon-mcp

API Usage

Available Tools

• search_icons: Search icons using comma-separated keywords (max 20 keywords)
• Returns: Top 5 most relevant icons with metadata and confidence scores

Example Request

{
  "name": "search_icons",
  "arguments": {
    "keywords": "layout, grid, design, interface"
  }
}

Response Format

• Ranked icon results with metadata
• Matched keywords and relevance scores
• Usage recommendations and categories
• Natural language summaries for AI consumption

Technical Specifications

Performance Metrics

• Search Response Time: < 10ms for local searches
• Index Size: Optimized for minimal memory footprint
• Concurrent Requests: Supports multiple simultaneous searches
• Keyword Limit: 20 keywords per search for optimal results

Compatibility

• Node.js: >= 18.0.0 required
• MCP Protocol: Full Model Context Protocol v1.20.0 compliance
• TypeScript: 100% TypeScript implementation
• Platforms: Windows, macOS, Linux support

Dependencies

• @modelcontextprotocol/sdk: Official MCP SDK for protocol implementation
• flexsearch: High-performance search indexing
• zod: Runtime type validation and schema enforcement
• tsx: TypeScript execution for development

Development & Contributing

Development Commands

pnpm typecheck    # Strict TypeScript checking
pnpm test         # Comprehensive test suite
pnpm lint         # Code formatting and linting
pnpm build        # Production build validation

Testing

• Unit Tests: Domain logic and validation rules
• Integration Tests: MCP protocol and search workflows
• CLI Tests: Command-line interface functionality
• Performance Tests: Search speed and memory usage

Roadmap

v1.1.0 (Planned)

• Enhanced semantic search with AI embeddings
• Icon preview and metadata enrichment
• Custom category management
• Search analytics and usage tracking

v1.2.0 (Planned)

• Multi-language icon descriptions
• Icon similarity and alternative suggestions
• Bulk icon operations
• Advanced filtering and sorting options

Community & Support

• GitHub Issues: Report bugs and request features
• Documentation: Complete setup and usage guides
• NPM Package: Install and version information
• Remix Icon: Original icon library

Acknowledgments

• Remix Icon: For the comprehensive icon library
• Model Context Protocol: For the standardized AI integration framework
• Cloudflare Workers: For inspiration in clean architecture patterns
• Contributors: Thank you to all who helped make this release possible

---

🎯 v1.0.0 represents a stable, production-ready foundation for intelligent icon search in AI applications. Install today and enhance your AI assistant's design capabilities!

🤖 Generated with Claude Code

Co-Authored-By: Claude noreply@anthropic.com

Release 0.4.0

Claude Code Plugin Support

This release adds official Claude Code plugin support, making it easier to install and use mcp-server-remix-icon with Claude Code.

Added

• Claude Code plugin support with marketplace.json
  • Added comprehensive marketplace.json for Claude Code plugin discovery
  • Configured plugin metadata including name, description, and author
  • Set up proper plugin directory structure in .claude-plugin/
  • Added Claude Code configuration documentation in README files

Changed

• Replaced .mcp.json with marketplace.json for better plugin management
• Updated README with Claude Code GitHub marketplace installation instructions
• Improved documentation structure for both English and Chinese versions

Fixed

• Corrected marketplace.json location to .claude-plugin/ directory
• Updated file references in documentation to reflect proper plugin structure

Installation

You can now install this MCP server directly from Claude Code:

```
/mcp install github:FradSer/mcp-server-remix-icon
```

Or via npx for standalone usage:

```bash
npx mcp-server-remix-icon
```

Full Changelog: v0.3.2...v0.4.0

v0.3.2 - Simplified MCP Output Format

What's Changed

Fixed

• Simplified MCP server output format for improved user experience
  • Removed verbose guidance text that appeared when multiple icons matched
  • Output now shows a clean list with only icon names and relevance scores
  • Added clear "Select the most suitable icon." prompt to guide users
  • Removed token information from output for cleaner, more focused results

Why This Matters

This change makes the MCP server responses more concise and easier to read when searching for icons. Instead of lengthy instructions, users now get a straightforward list of matching icons with scores, making it faster to select the right icon for their needs.

Also Included

• Enhanced Claude Desktop configuration documentation
• Improved README structure with clearer setup instructions for both macOS and Windows

Full Changelog: v0.3.1...v0.3.2

---

🤖 Generated with Claude Code

v0.3.1

Fixes

• Add npm publish configuration (files, engines, extended keywords)
• Fix type safety with optional chaining in search repository
• Move tsx to dependencies for runtime execution

Full Changelog: v0.3.0...v0.3.1

v0.2.0

Added

• CLI runner infrastructure for standalone execution
  • Added bin/run.cjs entry point for npx/npm execution
  • New src/cli/ directory with CLI implementation
  • Package.json bin field for global installation support
• Enhanced keyword parser with improved detection logic
  • Support for up to 20 comma-separated keywords
  • Better differentiation between keyword lists and natural language sentences
  • Delimiter-based detection allows richer keyword input
  • Comprehensive test coverage for new detection patterns

Changed

• BREAKING: Removed configurable limit parameter from search API
  • Fixed result count to 5 icons for all searches
  • Simplified API surface by removing unnecessary configuration
  • Updated search_icons tool to no longer accept limit argument
• Improved keyword vs sentence detection algorithm
  • Space-separated inputs with 4+ words now correctly detected as sentences
  • Comma-separated inputs support up to 20 keywords before triggering sentence detection
  • Stop word detection works with delimiters for better accuracy
• Updated documentation to reflect CLI availability and fixed result count

Fixed

• Downgraded Zod dependency from 4.1.12 to 3.25.76
  • Resolved breaking changes incompatible with MCP SDK
  • Fixed TypeScript configuration compatibility issues
• Corrected test suites to match new API behavior (removed limit tests)