MCP server for 340k SVG icons

340,000+ SVG icons — searchable, customizable, and a package manager for your icon codebase.

Website + API + CLI + MCP. Find any icon, write it into the project as source (no giant dependency), migrate mixed icon libraries, and let AI agents use the same engine.

Repo: github.com/LeulAria/Aria-Icons

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

The npm package name is aria-icons (verified unused on the registry at the time of adding the CLI). The CLI is tiny: it talks to the Aria Icons API and only downloads the icons you request.

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

Icon ids: collection:name (lucide:house, tabler:arrow-up, thesvg:github).

Full CLI docs: packages/cli/README.md.

Local (stdio) — what aria-icons setup writes:

{
  "mcpServers": {
    "aria-icons": {
      "command": "npx",
      "args": ["-y", "aria-icons"]
    }
  }
}

Remote HTTP — same catalog, hosted with the website:

{
  "mcpServers": {
    "aria-icons": {
      "url": "https://icons.leularia.com/api/mcp"
    }
  }
}

Public REST used by the CLI (tiny payloads, no icon database in the package):

During local development:

ARIA_ICONS_API=http://localhost:3001 bun run cli:dev -- search house

First, install the dependencies:

bun install

Fetch the brand + Iconify icon sources (one-time, or whenever you want to refresh), then rebuild the search catalog:

cd apps/web
bun run fetch:thesvg          # ~6,500 brand logos (~4s)
bun run fetch:iconify -- --all  # 200+ Iconify sets (~80s)
bun run generate-icons        # build icons-meta.json for search + MCP

Then, from the repo root, run the development server:

bun run dev

Open http://localhost:3001 in your browser. The in-app Contribute Icons page (/contribute) walks through adding a new set.

Icons come from three storage backends, all indexed into one catalog:

After fetching, rebuild the search catalog:

cd apps/web
bun run generate-icons

This writes public/icons-meta.json (browser + MCP search index with names, tags, aliases, and categories) and icons-name.json.

Every icon set here was contributed or curated by the community — new sets and better metadata are always welcome. The in-app guide at /contribute walks through it, and the short version is:

1. ForkLeulAria/Aria-Icons and clone your fork.
2. Add SVGs underapps/web/icons/<your-set-name>/ (lowercase, hyphenated file names — the file name becomes the icon name).
3. Register the set inapps/web/src/lib/icon-sets.ts (id, label, homepage, and whether it'sline orsolid style).
4. Pack + rebuild withbun run pack:icons -- --delete && bun run generate-icons insideapps/web .
5. Preview withbun run dev — check the sidebar, grid rendering, and search.
6. Open a pull request againstLeulAria/Aria-Icons mentioning the icon count, source, and license.

Other ways to contribute:

• Brand icons — contribute upstream totheSVG , then refresh withbun run fetch:thesvg .
• Iconify sets — pull additional collections withbun run fetch:iconify -- --sets <prefix> .
• Metadata — better tags/aliases make search smarter; metadata PRs are just as valuable as new icons.

Only submit icons you have the right to share, and include the license in your PR (MIT, CC0, or similarly permissive licenses preferred).

aria-icons/
├── apps/
│   └── web/               # Next.js app, catalog, /api/v1, HTTP MCP
├── packages/
│   ├── cli/               # published npm package `aria-icons`
│   ├── api/               # oRPC layer
│   └── config/
bun install

bun run dev:web                          # http://localhost:3001
bun run build                            # turbo: web + cli

bun run cli:dev -- search house
bun run cli:dev -- get lucide:house
bun run cli:dev -- doctor

ARIA_ICONS_API=http://localhost:3001 bun run cli:dev -- search house

bun run cli:test
bun run check-types

bun run cli:release

Manual npm publish:

cd packages/cli
bun run build
npm publish --access public

Pre-release:

cd packages/cli
bunx bumpp prerelease --preid beta --commit --tag --push

Website deploy is unchanged (Vercel / your current host for apps/web). After deploy, /api/v1/* and /api/mcp are what the CLI and remote MCP use.

• bun run dev : Start all applications in development mode
• bun run build : Build all applications
• bun run check-types : Check TypeScript types across all apps
• bun run cli:dev : Run the CLI from source
• bun run cli:build : Bundle the CLI for npm
• bun run cli:release : Version, tag, and push the CLI

Inside apps/web:

• bun run fetch:thesvg : Fetch/refresh theSVG brand icons (packs intoicons/thesvg.json )
• bun run fetch:iconify : Fetch Iconify sets (-- --sets a,b ,-- --all )
• bun run pack:icons : Collapse loose SVG folders into one JSON per set (-- --delete removes sources)
• bun run generate-icons : Rebuild the icon search catalog