Remixicon MCP

RemixIcon MCP（注：MCP在此处可能是一个特定上下文或项目中的缩写，但没有具体上下文，可将其直译为“MCP”，实际含义需根据上下文确定）

英语 | 简体中文

一个轻量级（的程序/应用/系统等） 模型上下文协议 (MCP) 服务器，它将图标相关的关键词直接映射到Remix Icon的元数据。提供简洁的关键词（最多20个），即可获得匹配度最高的5个图标名称及元数据——采用FlexSearch驱动的本地搜索，架构清晰。

特点/特性

• 智能关键词输入 – 支持最多20个以逗号分隔的关键词，同时拒绝自然语言句子以确保最佳搜索质量。
• 固定前五名结果 – 精确返回5个最相关的图标，以辅助决策。
• 基于FlexSearch的索引 – 使用 FlexSearch v0.8 的文档索引，在本地 Remix Icon 目录上实现高性能的令牌查找。
• 清洁架构 – 领域实体、应用用例、基础设施适配器和MCP接口保持隔离，以便于测试。
• CLI就绪 – 可以作为独立的命令行界面（CLI）工具运行 npx remixicon-mcp 或者集成到MCP客户端中。
• 适用于大型语言模型（LLM）的响应 – 返回排序后的候选图标、匹配的标记以及明确的指导，指示模型选择且仅选择一个图标。

快速入门

安装

# Install as CLI tool globally
npm install -g remixicon-mcp

# Or run directly with npx
npx remixicon-mcp

# For development
pnpm install
pnpm typecheck
pnpm test

使用方法

作为独立的命令行界面工具

您可以直接通过标准输入输出（stdio）运行MCP服务器进行测试或集成：

# Run with npx
npx remixicon-mcp

# Or if installed globally
remixicon-mcp

平台设置

Claude Desktop（可译为“Claude桌面版”或保持原样，根据上下文判断是否需要具体翻译）

配置 在你的（内容/列表/等）中添加以下内容 claude_desktop_config.json：

macOS（苹果电脑操作系统）： ~/Library/Application Support/Claude/claude_desktop_config.json\ Windows: %APPDATA%\Claude\claude_desktop_config.json

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

设置步骤

1. 保存配置文件
2. 完全退出并重新启动 Claude Desktop
3. 该 search_icons 该工具将在您的对话中可用

克劳德·科德

选项1：市场插件（推荐）

# In Claude Code, add the marketplace plugin
/plugin marketplace add Remix-Design/remixicon-mcp

好处：

• 自动安装和更新
• 完整的插件元数据和版本控制
• 通过关键词和分类进行丰富的发现
• 与Claude Code的插件生态系统全面集成

选项2：手动配置

# Quick command-line setup
claude mcp add --transport stdio remixicon -- npx -y remixicon-mcp

或者手动添加到您的项目中 .claude/settings.json：

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

设置步骤

1. 选择上述安装方法之一
2. 重启Claude代码以使更改生效
3. 这个 search_icons 该工具将在您的会话中可用

《科德克斯》（Codex）

配置

# Quick command-line setup
codex mcp add remixicon -- npx -y remixicon-mcp

设置步骤

1. 运行上述安装命令
2. 重启 Codex 以使更改生效
3. 这个（或：那个，具体根据上下文确定） search_icons 该工具将在您的对话中可用

可用工具

服务器通过官方渠道使用JSON-RPC 2.0协议通过标准输入输出（stdio）进行通信 @modelcontextprotocol/sdk 并展示了一个单一的工具：

search_icons

输入: keywords 字符串（逗号分隔，最多20个关键词）\ 输出包含元数据的前5个最相关图标\ 格式可读性摘要 + 结构化元数据

示例用法

JSON-RPC 调用：

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "search_icons",
    "arguments": {
      "keywords": "layout, grid, design"
    }
  }
}

示例回答： 服务器返回与您的关键词匹配的前5个图标，包括名称、类别和使用信息。

项目结构

.
├── bin/
│   └── run.cjs                     # CLI entry point for npx execution
├── src/
│   ├── cli/                        # CLI runner implementation
│   ├── bootstrap/                  # Dependency wiring for Clean Architecture boundaries
│   ├── domain/                     # Icon entities and keyword parser
│   ├── application/                # Search use case orchestrating validation and ranking
│   ├── infrastructure/search/      # FlexSearch-backed repository implementation
│   ├── interface/mcp/              # MCP server built with @modelcontextprotocol/sdk
│   └── data/tags.json              # Remix Icon tags for search functionality
├── tests/                          # Vitest suites covering parser and use case behaviour
├── .claude-plugin/
│   └── marketplace.json            # Marketplace metadata for Claude Code plugin discovery
├── package.json                    # pnpm-friendly manifest and scripts
└── tsconfig.json                   # Strict TypeScript configuration with Node typings

实施说明

• 关键词使用Unicode感知边界进行解析，支持最多20个由逗号分隔的关键词，同时拒绝句式风格的输入。
• 增强的检测功能能够区分关键字列表（带分隔符）和自然语言句子（空格分隔的短语）。
• FlexSearch对图标名称、标签、使用情况和类别进行索引；字段权重加上令牌匹配决定确定性得分。
• 固定的前五名结果提供了精准且相关的匹配，无需复杂的配置。
• 应用层结合了解析器验证、仓库查询和响应格式化功能，因此接口仅处理传输相关的问题。
• MCP（可能是指某种配置或控制协议）的响应包括自然语言指导和机器可读的匹配项，以便大型语言模型（LLM）客户端能够准确选择一个图标。
• CLI 运行器支持通过（某种方式）进行独立执行 npx 或进行全局安装以方便集成。

开发脚本

pnpm typecheck   # Strict TypeScript check (tsc --noEmit)
pnpm test        # Run Vitest suites
pnpm exec biome check --write --unsafe   # Format + fix code with Biome

许可证

麻省理工学院许可证（MIT License）