cisco-network-diagrams-mcp-server

MCP server exposing the 308 official icons from the Cisco Systems Corporate Iconography package — the free-to-use icon set Cisco itself distributes for diagrams and materials — so an LLM can look up the right icon and fetch it as an image while building a network topology diagram.

All icons are shipped pre-converted from Cisco's original CMYK JPEGs to RGB PNG. The CMYK originals render blank, discolored, or cropped in most web/collaborative tools (Miro, Figma, FigJam, browsers) — this fixes that at the source, and the PNGs are ~4x smaller too.

Tools

Tool	Description
cisco_list_categories	List the 7 catalog categories with icon counts.
cisco_search_icons	Keyword search across id/name/description (metadata only).
cisco_list_icons	Paginated listing, optionally filtered by category or curated-only.
cisco_get_icon	Fetch one icon's metadata and its RGB PNG image by id.

29 of the 308 icons are curated: the equipment most common in classroom/enterprise topologies (router, switch, firewall, server, access point, cloud, etc.), annotated with glossary_name, function, and when_to_use in addition to the base description every icon has.

Installation

npm install -g cisco-network-diagrams-mcp-server

Or run without installing:

npx cisco-network-diagrams-mcp-server

Usage with an MCP client

Add to your client's MCP server config (e.g. Claude Desktop's claude_desktop_config.json):

{
  "mcpServers": {
    "cisco-network-diagrams": {
      "command": "npx",
      "args": ["-y", "cisco-network-diagrams-mcp-server"]
    }
  }
}

Placing icons on a canvas

The icons are not square — e.g. router is ~77×52 px. When placing the image returned by cisco_get_icon onto a fixed-size node (Figma, FigJam, Miro, etc.), use a FIT scale mode, never FILL — FILL stretches or crops non-square icons.

License

The icons are Cisco's registered trademark artwork. Cisco authorizes free use in diagrams and materials, unaltered (no redrawing, recoloring the artwork, or distorting proportions). The CMYK→RGB conversion in this package is a technical compatibility fix (same color, different color space), not a visual alteration.

This package's own code is MIT-licensed; the icon artwork itself remains Cisco's property under Cisco's usage terms.