Keyline Icons

@keyline-icons/mcp

Um servidor MCP para Keyline Icons. Permite que um agente pesquise o conjunto, leia o SVG de um ícone e obtenha a importação React correta, sem adivinhar nomes.

Instalação

Claude Code:

claude mcp add keyline-icons -- npx -y @keyline-icons/mcp

Qualquer outra ferramenta que fale MCP via stdio:

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

Sem chave de API, sem rede. O conjunto completo vem dentro do pacote.

Ferramentas

Ferramenta	O que faz
describe_set	Contagens, estilos e a regra que decide quais ícones têm qual estilo. Vale a pena chamar primeiro.
search_icons	Encontra ícones por nome. Retorna quais estilos cada um possui.
get_icon	Código-fonte SVG completo para um nome, estilo e tratamento de canto, regular ou sharp.
get_react_usage	A linha de importação e o JSX de @keyline-icons/react, incluindo pontos de entrada nítidos.

Por que as ferramentas são moldadas assim

Nomes são adivinháveis, mas não óbvios. Compostos são lidos com a base primeiro, então um ícone de e-mail com um visto é mail-check e não check-mail, e contêineres são prefixos: square-arrow-down. search_icons classifica exato sobre prefixo sobre limite de palavra sobre substring, então pesquisar check retorna check antes dos doze compostos que o contêm.

Um estilo ausente é uma resposta real, não um erro. bar-chart são três traços abertos sem interior, então não tem preenchimento, e a ferramenta diz exatamente isso em vez de retornar nada. Duotone e fill precisam de uma região preenchível, que vem da área fechada do próprio glifo ou de um contêiner quadrado/circular.

Erros de digitação são resolvidos em uma rodada. Um nome que não corresponde é encontrado por substring, depois por distância de edição, depois por segmento inicial, então chekc sugere check e arow sugere a família arrow-* mesmo que não exista um ícone arrow isolado.

Licença

MIT.