vezham-icons-mcp

MCP server and CLI for searching, previewing, and applying Vezham icons. Works fully offline with a prebuilt search index.

MCP Server

Add to your MCP client config:

{
  "mcpServers": {
    "vezham": {
      "command": "npx",
      "args": ["@vezham/icons-mcp"]
    }
  }
}

Or point directly at the local binary after building:

{
  "mcpServers": {
    "vezham": {
      "command": "node",
      "args": ["/path/to/vezham/packages/icons-mcp/bin/run.cjs"]
    }
  }
}

Tools

| Tool | Description | | :--- | :--- | | search_icons | Rank icons by keyword | | view_icon | Return raw SVG markup and metadata | | apply_icon | Generate framework-specific import and docs snippets | | list_categories | List all icon categories |

CLI

npx @vezham/icons-mcp search "shopping cart"
npx @vezham/icons-mcp view heart --weight filled
npx @vezham/icons-mcp apply heart --framework react --size 32 --color "#ef4444"
npx @vezham/icons-mcp categories

File write mode

For scripted insertion, replace a marker string in a target file:

npx @vezham/icons-mcp apply heart --framework react --file src/App.tsx --marker "{/* ICON */}"

The marker must exist exactly once. The command exits non-zero if the marker is not found.

Build

From the monorepo root:

npm run build:mcp

MIT © Dev Chauhan