$git clone https://github.com/cisco-open/network-sketcherNetwork Sketcher is an AI-native network design and diagramming tool. It generates L1/L2/L3 topology diagrams, device tables, and AI-ready context files from structured network data and natural-language workflows.
| 1 | <p align="center"> |
| 2 | <img src="https://github.com/user-attachments/assets/cc82082d-c4a5-4f13-90f5-adaf162202b2" alt="image" /> |
| 3 | </p> |
| 4 | |
| 5 | <p align="center"> |
| 6 | <a href="https://glama.ai/mcp/servers/cisco-open/network-sketcher"> |
| 7 | <img src="https://glama.ai/mcp/servers/cisco-open/network-sketcher/badges/score.svg" alt="Glama MCP score" /> |
| 8 | </a> |
| 9 | |
| 10 | <a href="https://lobehub.com/mcp/cisco-open-network-sketcher"> |
| 11 | <img src="https://lobehub.com/badge/mcp/cisco-open-network-sketcher" alt="LobeHub MCP" /> |
| 12 | </a> |
| 13 | </p> |
| 14 | |
| 15 | # Network Sketcher |
| 16 | |
| 17 | **Network Sketcher is an AI-native network design and diagramming tool. It generates L1/L2/L3 topology diagrams, device tables, and AI-ready context files from structured network data and natural-language workflows.** |
| 18 | |
| 19 | For MCP users, **Network Sketcher Local MCP** lets LLM clients such as Cursor and Claude Code design Cisco-style networks directly through Model Context Protocol tool calls. It runs locally over stdio, keeps master files on your machine, and produces SVG / PowerPoint diagrams plus HTML device tables. |
| 20 | |
| 21 | If Network Sketcher helps your workflow, please consider starring the repository. |
| 22 | |
| 23 | Common use cases: |
| 24 | |
| 25 | - Build a 5-site WAN or campus LAN design from an AI conversation |
| 26 | - Generate L1 physical, L2 VLAN/broadcast-domain, and L3 IP topology diagrams |
| 27 | - Export a combined L1/L2/L3 HTML viewer and an interactive device table |
| 28 | - Create an AI Context file so another LLM can review or extend the network design |
| 29 | - **Import from live inventory:** Use [Network Sketcher Cisco Extension](https://github.com/CiscoDevNet/network-sketcher-cisco-extension) converters to turn ACI, Catalyst Center, Meraki, Nexus Dashboard, CML, Cyber Vision, SNA, NetBox exports, or config files (IOS / IOS-XE / NX-OS / IOS-XR / ASA) into CLI commands for any Network Sketcher edition |
| 30 | |
| 31 | ## Quick Start: Local MCP in 3 Steps |
| 32 | |
| 33 | <img alt="ns_demo_mcp" src="https://github.com/user-attachments/assets/1b9a85f9-0785-4dbb-b980-68ec0c1f31c9" /> |
| 34 | |
| 35 | |
| 36 | |
| 37 | The quickest way to try Network Sketcher with an AI agent is the Local MCP edition. |
| 38 | |
| 39 | ### 1. Install |
| 40 | |
| 41 | ```bash |
| 42 | git clone https://github.com/cisco-open/network-sketcher/ |
| 43 | cd network-sketcher/network-sketcher_local_mcp |
| 44 | python -m pip install -r requirements_mcp.txt |
| 45 | ``` |
| 46 | |
| 47 | ### 2. Add it to your MCP client |
| 48 | |
| 49 | For Cursor, add this to your MCP configuration: |
| 50 | |
| 51 | ```json |
| 52 | { |
| 53 | "mcpServers": { |
| 54 | "network-sketcher": { |
| 55 | "command": "python", |
| 56 | "args": [ |
| 57 | "/path/to/network-sketcher/network-sketcher_local_mcp/ns_mcp_server.py" |
| 58 | ] |
| 59 | } |
| 60 | } |
| 61 | } |
| 62 | ``` |
| 63 | |
| 64 | For Claude Code: |
| 65 | |
| 66 | ```bash |
| 67 | claude mcp add network-sketcher -- python "/path/to/network-sketcher/network-sketcher_local_mcp/ns_mcp_server.py" |
| 68 | ``` |
| 69 | |
| 70 | Replace `/path/to/network-sketcher/` with your local clone path. |
| 71 | |
| 72 | ### 3. Ask your agent to build a network |
| 73 | |
| 74 | Example prompt: |
| 75 | |
| 76 | ```text |
| 77 | Using Network Sketcher Local MCP, create a small 5-site WAN design with HQ, two data centers, two branches, Internet and WAN waypoints, edge routers, simple L2 segments, and representative IP addressing. Then build the default L1/L2/L3 diagrams and device table. |
| 78 | ``` |
| 79 | |
| 80 | The generated files will be saved in your Network Sketcher workspace. |
| 81 | |
| 82 | <img alt="image" src="https://github.com/user-attachments/assets/26068524-6293-4f7f-ab0c-f6b7e2c8b842" /> |
| 83 | |
| 84 | <img alt="image" src="https://github.com/user-attachments/assets/b3501923-195e-45bc-9120-f6b78396e300" /> |
| 85 | |
| 86 | |
| 87 | |
| 88 | ## Ecosystem & Integrations |
| 89 | |
| 90 | Network Sketcher Local MCP is listed on the official MCP Registry and major MCP platforms: |
| 91 | |
| 92 | - **Registries:** [MCP Registry](https://registry.modelcontextprotocol.io/?q=network-sketcher) · [Glama](https://glama.ai/mcp/servers/cisco-open/network-sketcher) · [PulseMCP](https://www.pulsemcp.com/servers/network-sketcher) |
| 93 | - **Hubs:** [LobeHub](https://lobehub.com/mcp/cisco-open-network-sketcher) |
| 94 | |
| 95 | Network Sketcher provides three editions: |
| 96 | |
| 97 | - [**Network Sketcher Local MCP**](#network-sketcher-local-mcp) — **AI-native MCP server for LLM clients (Cursor, Claude Code, etc.)**. The most direct AI integration: the LLM |