# Aria Icons [Health: Active]

**Category:** 💻 Developer Tools  
**Repository:** https://github.com/LeulAria/Aria-Icons  
**GitHub Stars:** 107  
**npm Downloads (last month):** 178  
**Views:** 4  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/aria-icons

## Description
340k SVG icons — browser, CLI (writes source), and MCP for Cursor/Claude.

## Tools
Capabilities this server exposes over MCP:

- **search_icons** — Search 340k+ icons across Aria Icons collections. Returns ids like lucide:house for get_icon / add.
- **get_icon** — Get SVG + React/Vue/Svelte snippets for an icon id (lucide:house).
- **get_icon_svg** — Get only the SVG string for an icon.
- **get_icon_component** — Get a single-framework component for an icon.
- **get_icons** — Batch-get up to 20 icons.
- **list_collections** — List Aria Icons collections with icon counts.
- **find_similar_icons** — Same icon in other collections, plus related names.
- **find_equivalent_icon** — Map an icon to the closest match in a target collection.
- **recommend_icons** — Recommend icons for a UI use case.
- **get_recent_icons** — Icons this machine recently fetched via the CLI/MCP.
- **add_icon_to_project** — Download an icon and write it into the project's icons folder (shadcn-style, no giant dependency). Detects framework unless provided.
- **scan_project_icons** — Scan the current project for third-party icon library usage.

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

```json
"mcpServers": {
  "aria-icons": {
    "command": "npx",
    "args": ["-y","aria-icons@latest"]
  }
}
```

## Documentation

## What Aria Icons does

The Aria Icons MCP server exposes a searchable catalog of SVG icon collections to MCP-compatible clients. It provides access to icons by identifiers such as `lucide:house`, `tabler:arrow-up`, and `thesvg:github`. An agent can search the catalog, retrieve one or more icons, inspect available collections, find similar icons, and map an icon to an equivalent in another collection.

The catalog combines vendored sets, theSVG brand logos, and Iconify collections. Search metadata includes names, tags, aliases, and categories. The same underlying catalog is available through the website, public REST API, CLI, and MCP endpoint.

As a Developer Tools listing, the Aria Icons MCP server fits workflows where an agent needs to select icons and return SVG or framework source. The companion CLI can also write requested icon files into a repository, audit mixed icon libraries, recommend a consistent collection, and migrate imports toward another set.

## How it works

The local mode runs the published `aria-icons` package as a stdio MCP process. The package makes requests to the Aria Icons API rather than bundling the full icon database, so the CLI downloads only the icons requested. The default MCP command is available by running the package without additional arguments.

A remote configuration points an MCP client at `https://icons.leularia.com/api/mcp`. Both local and remote modes use the same catalog. The related REST API provides endpoints for search, single-icon retrieval, batch retrieval, collection listing, similar-icon lookup, and cross-set equivalent mapping.

## Setup and configuration

Install or configure the CLI with one of these supported approaches:

- `npx -y aria-icons@latest setup`
- `bunx aria-icons@latest setup`
- `curl -fsSL https://icons.leularia.com/install.sh | bash`

The `setup` command writes an MCP configuration using `npx -y aria-icons` as the local command. The README identifies Cursor, Claude, and VS Code as setup targets. For a remote configuration, use the hosted MCP URL instead of a command and argument list.

For local development against a self-hosted website, set `ARIA_ICONS_API` to the development API URL, such as `http://localhost:3001`. This variable is shown for development and is not required for the hosted service.

## Tools and capabilities

The Aria Icons MCP server supports catalog operations corresponding to these capabilities:

- Search icons across collections.
- Retrieve an individual icon or a batch of icons.
- Browse available collections.
- Find similar icons or alternatives in other sets.
- Map an icon to an equivalent in a selected collection.
- Return SVG or framework source through the CLI workflow.

The CLI adds repository-oriented commands such as `add`, `migrate`, `doctor`, `suggest`, and `init`. These commands are separate from the MCP transport but use the same API-backed icon catalog.

## Limitations and notes

The npm package does not contain the complete icon database; it depends on the Aria Icons API for catalog and icon data. Icon contributions must include appropriate sharing rights and license information, so the license terms may vary between collections.

_Full upstream README: https://allmcps.com/mcp/aria-icons/readme_

