网络设计工具

Requirement (Local MCP)

• Python 3.10 or later (required by the MCP SDK; the engine itself supports 3.9+)
• The full Network Sketcher repository (the network-sketcher_online/ folder must be present)
• Recommended LLM: Claude Opus 4.7 or later. The Local MCP edition relies heavily on multi-step tool calling, schema interpretation, and adherence to the layout / workflow rules embedded in the server instructions and AI Context (e.g., RULE 0 / 0.5 layout, RULE 3.5 multi-transport WAN waypoint design, mandatory get_workspace_info to get_ai_context bootstrap). Weaker or older models may struggle with these workflows.

Requirement (Online)

• Tested on Windows only. It may work on Mac OS and Linux, but these platforms have not been verified.
• Other requirements are the same as Network Sketcher Offline.

Requirement (Offline)

• Network Sketcher supports cross-platform. Works with Windows, Mac OS, and Linux.
• MAC OS may not display well in Dark mode.
• Python ver 3.x
• Software that can edit .pptx and .xlsx files
• Microsoft Powerpoint and Excel are the best
• Google Slides and Spreadsheets import/export functionality is available. Excel functions display will show an error, but it works fine.
• Libre Office and Softmaker office cannot be used.

Installation (Local MCP)

git clone https://github.com/cisco-open/network-sketcher/
cd network-sketcher/network-sketcher_local_mcp
python -m pip install -r requirements_mcp.txt

Installation (Online)

git clone https://github.com/cisco-open/network-sketcher/
cd network-sketcher/network-sketcher_online
python3 -m pip install -r requirements_online.txt
cd ..
python3 start_ns_online.py

Open the URL shown at startup (default: https://localhost:5443) in your browser.

• To serve on a specific network interface, edit the host and port settings in ns_web_config.json before starting the server.
• If no SSL certificate exists, a self-signed certificate is auto-generated on first startup.
• If you change the host IP address or other settings in ns_web_config.json, manually delete the SSL certificate files in the Certs/ folder and restart the server. A new certificate matching the updated settings will be auto-generated.
• If the fqdn setting in ns_web_config.json is configured, the auto-generated SSL certificate's Common Name (CN) will use the specified FQDN.

Installation (Offline)

git clone https://github.com/cisco-open/network-sketcher/
cd network-sketcher/network-sketcher_offline
python3 -m pip install -r requirements_offline.txt
python3 network_sketcher.py

#Download via browser
https://github.com/cisco-open/network-sketcher/archive/refs/heads/main.zip

#Unzip the ZIP file and execute the following in the prompt of the folder
cd network-sketcher_offline
python3 -m pip install -r requirements_offline.txt
python3 network_sketcher.py

Installation Supplement (Offline)

* Alternative to "python -m pip install -r requirements_offline.txt"

python3 -m pip install tkinterdnd2
python3 -m pip install "openpyxl>=3.1.3,<=3.1.5"
python3 -m pip install python-pptx
python3 -m pip install ipaddress
python3 -m pip install numpy
python3 -m pip install pyyaml
python3 -m pip install ciscoconfparse
python3 -m pip install networkx
python3 -m pip install svg.path

Mac OS requires the following additional installation.

brew install tcl-tk
brew install tkdnd

sudo apt-get install python3-tk

How to create the exe file for Windows using pyinstaller

pyinstaller.exe [file path]/network-sketcher_offline/network_sketcher.py --onefile --collect-data tkinterdnd2 --additional-hooks-dir  [file path] --clean --add-data "./ns_extensions_cmd_list.txt;." --add-data "./ns_logo.png;."
 

Connection Examples

Cursor and Claude Code use different configuration mechanisms, so the setup steps are split below. Pick the one that matches your client.

User Guide (Local MCP)

<br> <br>

<p align="center">━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━</p>

<br>

User Guide (Online)

Demo video of basic usage

https://github.com/cisco-open/network-sketcher/assets/13013736/b76ec8fa-44ad-4d02-a7c2-579f67ad24a9

User Guide (Offline)

5min Demo video of the Local MCP edition.

The AI ​​agent Cursor autonomously creates a network using Network Sketcher's Local MCP functionality. It also simultaneously references best practices from other MCPs.

https://github.com/user-attachments/assets/274d5b66-5f4a-407a-bfb5-f71026971fc4

Demo Video (Ver 3.0.1b)

A demo video of approximately 4 minutes, starting with the installation of Network Sketcher. This demo video demonstrates creating a network configuration using LLM from URL information and performing additional editing. No sound, no captions.

https://github.com/user-attachments/assets/2acaea3b-32f2-4ff0-90ad-a3dc810293d2

AI(LLM) utilization demo video

Full_Version_link(Youtube)

https://github.com/user-attachments/assets/5874411a-0e6d-485d-9f85-4cdc85f3ca07

SAMPLE