# mdi-mcp-server

MCP (Model Context Protocol) server for searching [Material Design Icons](https://materialdesignicons.com/) (MDI). Agents de IA pueden buscar iconos por nombre, alias, categoría o concepto directamente desde su cliente MCP.

## Tools

| Tool | Descripción |
|------|-------------|
| `search_icons` | Busca iconos por nombre, alias o keyword |
| `get_icon_by_name` | Obtiene detalle completo de un icono |
| `list_categories` | Lista todas las categorías disponibles |
| `list_icons_by_category` | Lista iconos de una categoría específica |
| `suggest_icons_by_concept` | Sugiere iconos según un concepto o caso de uso |

## Resources

| URI | Descripción |
|-----|-------------|
| `mdi://icons/{name}` | Detalle de un icono específico |
| `mdi://categories` | Lista de categorías |

## Uso

### Con npx (recomendado)

```json
{
  "mcpServers": {
    "mdi-icons": {
      "command": "npx",
      "args": ["-y", "mdi-mcp-server"]
    }
  }
}
```

### Local (tras clonar)

```bash
npm install
npm run build
npm link
mdi-mcp-server
```

## Ejemplos

```
search_icons(query: "patient", limit: 5)
  → account-injury, account-injury-outline, bed, bed-empty, ...

suggest_icons_by_concept(concept: "medical hospital", limit: 5)
  → hospital-box, hospital-marker, hospital, hospital-building, ...

get_icon_by_name(name: "account-circle")
  → Codepoint, Aliases: user-circle, person-circle, Tags: Account / User

list_categories()
  → 59 categorías: Home Automation, Medical / Hospital, Account / User, ...

list_icons_by_category(category: "Medical / Hospital", limit: 5)
  → account-heart, account-heart-outline, account-injury, ...
```

## Fuente de datos

Los metadatos se obtienen del [repositorio oficial de MDI](https://github.com/Templarian/MaterialDesign) e incluyen ~7200 iconos con nombre, codepoint, aliases, tags y estado de deprecated.

## Publicar

```bash
npm login
npm publish
```