IconStore
limengwei/iconstore
Buscador de ícones SVG com MCP server integrado para assistentes IA
Ver no GitHubMCP server cross-platform para busca, navegação e download de ícones SVG com banco de dados SQLite integrado. Disponível como aplicação desktop (Wails v3) ou servidor MCP standalone, oferecendo acesso a mais de 60 mil ícones com busca full-text e exportação em SVG/PNG.
Instalação
npx convez-ai limengwei/iconstore1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Buscar e exportar ícones SVG/PNG em cores e tamanhos customizados
- Integrar busca de ícones em fluxos de trabalho com Claude e Cursor via MCP
- Navegar biblioteca de 60k+ ícones organizados por pacotes e categorias
Veredito

Ferramenta prática que combina interface desktop (Wails v3 + Vue) com MCP server para integração em assistentes IA. Bem estruturado em Go com SQLite FTS5, atende designers e desenvolvedores que precisam automatizar busca de ícones em workflows com Claude.
README
A tradução para o português deste README ainda está na fila.
Screenshots
Features
- Icon Search — Full-text search powered by SQLite FTS5 across 60,000+ built-in icons
- Browse by Package/Category — Sidebar navigation to browse icons organized by packages and sub-categories
- Icon Preview — View icons at multiple sizes (16/24/32/48px) with real-time color preview
- Export — Download icons as SVG or PNG with custom size and color; native system save dialog
- Copy SVG — One-click copy of raw SVG code to clipboard
- MCP Server — Built-in MCP server (port 9393) for integration with AI tools like Claude Desktop, Cursor, etc.
- Cross-Platform — Runs on Windows, macOS, and Linux via Wails v3
Tech Stack
| Layer | Technology |
|---|---|
| Backend | Go, SQLite (modernc.org/sqlite), FTS5 |
| Frontend | Vue 3, Vite |
| Desktop Framework | Wails v3 |
| SVG Rendering | oksvg + rasterx (PNG export) |
Getting Started
Prerequisites
- Go >= 1.25
- Node.js (for frontend build)
- Wails v3 CLI
Development
wails3 dev
Build
wails3 build
MCP Standalone Mode
Run IconStore as an MCP server without the GUI:
iconstore --mcp # default port 9393
iconstore --mcp 8080 # custom port
MCP Integration
The embedded MCP server starts automatically when the desktop app runs, or can be launched standalone with --mcp.
Available Tools
| Tool | Description |
|---|---|
search_icons | Search icons by keyword, with optional category filter and pagination |
get_icon | Get raw SVG content by icon ID |
export_icon | Export icon as SVG or PNG with custom color and size |
Client Configuration
Add to your MCP client config (e.g. Claude Desktop, Cursor):
{
"mcpServers": {
"iconstore": {
"url": "http://127.0.0.1:9393/mcp"
}
}
}
Project Structure
├── main.go # Entry point, desktop app & MCP server startup
├── icon_service.go # Icon search, export, SQLite management
├── mcp_server.go # MCP JSON-RPC server implementation
├── dialog_service.go # Native file save dialog
├── iconstore.db # SQLite database (icons + FTS index)
├── frontend/
│ ├── src/
│ │ ├── App.vue # Main layout with search & pagination
│ │ ├── components/
│ │ │ ├── IconGrid.vue # Icon grid display
│ │ │ ├── IconDetail.vue # Icon detail panel with export options
│ │ │ ├── SearchBar.vue # Search input
│ │ │ ├── Sidebar.vue # Package/category navigation
│ │ │ ├── SubCategories.vue
│ │ │ ├── TitleBar.vue # Custom frameless title bar
│ │ │ ├── MCPDialog.vue # MCP configuration dialog
│ │ │ └── Toast.vue # Notification toast
│ │ └── main.js
│ ├── bindings/ # Wails auto-generated JS bindings
│ └── package.json
├── build/ # Platform-specific build configs
│ ├── windows/
│ ├── darwin/
│ ├── linux/
│ ├── android/
│ └── ios/
└── Taskfile.yml
License
This project uses icons from various open-source icon libraries. See individual package licenses for details.