Network Sketcher (Local MCP)

 

Network Sketcher

Network Sketcher 是一款原生支持 AI 的网络设计和绘图工具。它可根据结构化网络数据和自然语言工作流，生成 L1/L2/L3 拓扑图、设备表和适用于 AI 的上下文文件。

对于 MCP 用户，Network Sketcher Local MCP 可让 Cursor 和 Claude Code 等大模型客户端通过 Model Context Protocol 工具调用，直接设计 Cisco 风格的网络。它通过 stdio 在本地运行，将主文件保存在你的计算机上，并生成 SVG / PowerPoint 图表和 HTML 设备表。

如果 Network Sketcher 对你的工作流有帮助，请考虑为该仓库点星。

常见用例：

• 通过 AI 对话构建包含 5 个站点的 WAN 或园区 LAN 设计
• 生成 L1 物理拓扑、L2 VLAN/广播域拓扑和 L3 IP 拓扑图
• 导出整合 L1/L2/L3 的 HTML 查看器和交互式设备表
• 创建 AI Context 文件，供其他大模型审查或扩展网络设计
• **从实时清单导入：**使用 Network Sketcher Cisco Extension 转换器，将 ACI、Catalyst Center、Catalyst SD-WAN、Meraki、Nexus Dashboard、CML、Cyber Vision、SNA、NetBox 导出文件或配置文件（IOS / IOS-XE / NX-OS / IOS-XR / ASA）转换为适用于任何 Network Sketcher 版本的 CLI 命令

快速入门：3 步设置本地 MCP

通过 AI Agent 体验 Network Sketcher，最快的方式是使用 Local MCP 版本。

1. 安装

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

2. 将其添加到 MCP 客户端

对于 Cursor，将以下内容添加到 MCP 配置中：

{
  "mcpServers": {
    "network-sketcher": {
      "command": "python",
      "args": [
        "/path/to/network-sketcher/network-sketcher_local_mcp/ns_mcp_server.py"
      ]
    }
  }
}

对于 Claude Code：

claude mcp add network-sketcher -- python "/path/to/network-sketcher/network-sketcher_local_mcp/ns_mcp_server.py"

将 /path/to/network-sketcher/ 替换为本地克隆路径。

3. 让 Agent 构建网络

提示词示例：

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.

生成的文件将保存在 Network Sketcher 工作区中。

## 生态系统与集成

Network Sketcher Local MCP 已收录在官方 MCP Registry 和主流 MCP 平台：

• 注册表： MCP Registry · Glama · PulseMCP
• 平台： LobeHub

Network Sketcher 提供三个版本：

• Network Sketcher Local MCP — 面向大模型客户端（Cursor、Claude Code 等）的 AI 原生 MCP 服务。最直接的 AI 集成方式：大模型可直接调用 Network Sketcher 工具，无需浏览器或复制粘贴。
• Network Sketcher Online — 基于浏览器的 Web 服务。
• Network Sketcher Offline — 桌面 GUI + CLI。仅需 network-sketcher_offline/ 文件夹即可独立运行。

你可以任意组合使用。

	Local MCP（AI 原生）	Online（Web 服务）	Offline（GUI + CLI）
界面	大模型客户端（Cursor、Claude Code 等）	Web 浏览器	桌面 GUI / 命令行
主要依赖项	Python + MCP SDK	Python + Flask	Python + tkinter
多用户	单用户	多个用户通过浏览器使用	单用户
客户端要求	Python + MCP 客户端	仅需 Web 浏览器	Python 运行时环境
AI 原生设计	是（最直接）	是	否
主格式	.nsm only	.xlsx / .nsm 均可	.xlsx only
内部数据存储	否	否	否
外部通信	通过 stdio 与大模型客户端通信（本地）	HTTPS	否
已测试平台	Windows（按设计兼容 Mac OS、Linux）	Windows（未在 Mac OS、Linux 上测试）	Windows、Mac OS、Linux
文件夹	network-sketcher_local_mcp/	network-sketcher_online/	network-sketcher_offline/

network-sketcher/
├── network-sketcher_local_mcp/  # Local MCP edition — MCP server for LLM clients (AI-native)
├── network-sketcher_online/     # Online edition — Web service (browser-based)
├── network-sketcher_offline/    # Offline edition — GUI + CLI (standalone desktop app)
├── README.md
├── LICENSE
└── ...

扩展：Cisco 和第三方转换器

Network Sketcher Cisco Extension 仓库（Cisco DevNet）是一个独立的单体仓库，其中包含可将平台导出文件或只读 API 快照转换为 Network Sketcher CLI 命令脚本（ns_commands.txt）的转换器。生成的输出适用于所有三个版本——Local MCP、Online 和 Offline（GUI / CLI）。

转换器： ACI · Catalyst Center · Catalyst SD-WAN · CML · Cyber Vision · Meraki · Nexus Dashboard (NDFC) · Secure Network Analytics · NetBox · template_converter

了解更多： 典型工作流 · 工具概览 · 第三方转换器 · 构建自己的转换器

使用 Local MCP 时，AI Agent 可以运行转换器，通过 run_commands 输入 ns_commands.txt，并在同一会话中使用 build_default_outputs 完成操作。

转换器的输出只是一个初始草稿——有关数据质量方面的注意事项和验证指南，请参阅 Cisco Extension README。

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Network Sketcher Local MCP

AI 原生版本： Network Sketcher Local MCP 将引擎作为 Model Context Protocol (MCP) 服务提供，使 Cursor 和 Claude Code 等大模型客户端能够直接驱动网络设计。这是三个版本中最直接的 AI 集成方式——无需浏览器，也无需复制粘贴。

什么是 Network Sketcher Local MCP？

Network Sketcher Local MCP 是 Network Sketcher 的第三个版本。它将 network-sketcher_online/ns_engine/ 封装为库，并通过 Model Context Protocol 提供 Network Sketcher CLI，使大模型客户端能够通过工具调用驱动网络设计。

定位： Online 版本是“浏览器 + 人工 + 大模型（复制粘贴）”；Offline 版本是“桌面 GUI / CLI”；此版本则是**“AI 原生——大模型直接执行 CLI”**。

Local MCP 版本的 5 分钟演示视频。

AI Agent Cursor 使用 Network Sketcher 的 Local MCP 功能自主创建网络。同时，它还会参考其他 MCP 中的最佳实践。

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

本地 MCP 功能

• 无需浏览器，也无需复制粘贴。 大模型通过工具调用执行 add device ... 等命令
• 将 network-sketcher_online/ns_engine/ 作为库复用（不重复编写代码）
• 不会对现有的 _online / _offline 文件夹做任何修改
• 使用 stdio 传输（专为本地运行设计）
• **平台导入工作流：**参见上文的扩展：Cisco 和第三方转换器（run_commands + build_default_outputs）

限制（本地 MCP）

• 面向在本地 PC 上运行的单用户版本
• 仅支持 stdio 传输（不支持 HTTP/SSE）
• 生成大型网络图可能需要一些时间
• 大模型客户端无法直接查看二进制输出（PPTX / SVG）；如需查看图像，用户应直接打开生成的 SVG
• **验证状态：**已在 Cursor 和 Claude Code 中完成端到端验证。服务遵循标准 MCP 规范，因此预计任何兼容 MCP 的 AI Agent/客户端均可使用，不限于这两者。

要求（本地 MCP）

• Python 3.10 或更高版本（MCP SDK 所需；引擎本身支持 3.9+）
• 完整的 Network Sketcher 仓库（必须包含 network-sketcher_online/ 文件夹）
• **推荐的大模型：Claude Opus 4.7 或更高版本。**本地 MCP 版本高度依赖多步骤工具调用、模式解读，以及遵循服务指令和 AI 上下文中嵌入的布局/工作流规则（例如 RULE 0 / 0.5 布局、RULE 3.5 多传输 WAN 航点设计，以及必须先调用 get_workspace_info 再调用 get_ai_context 的引导流程）。能力较弱或较旧的模型可能难以处理这些工作流。

安装（本地 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

连接示例

Cursor 和 Claude Code 使用不同的配置机制，因此以下设置步骤分开列出。请选择与客户端相符的步骤。

适用于 Cursor

将以下内容添加到 Cursor MCP 配置文件（File > Preferences > Cursor Settings > MCP → mcp.json）：

{
  "mcpServers": {
    "network-sketcher": {
      "command": "python",
      "args": [
        "/path/to/network-sketcher/network-sketcher_local_mcp/ns_mcp_server.py"
      ]
    }
  }
}

将 /path/to/network-sketcher/ 替换为克隆仓库的实际路径。 在 Windows 上，可以使用正斜杠（/）或转义后的反斜杠（\\）。

适用于 Claude Code

使用 claude CLI 注册 MCP 服务。必须使用 --（双连字符）分隔符，这样脚本路径才会传递给 python，而不会被解析为 claude mcp add 的标志：

# Local scope (default; current project only, stored in ~/.claude.json)
claude mcp add network-sketcher -- python "/path/to/network-sketcher/network-sketcher_local_mcp/ns_mcp_server.py"

# User scope (available across all your projects)
claude mcp add --scope user network-sketcher -- python "/path/to/network-sketcher/network-sketcher_local_mcp/ns_mcp_server.py"

# Project scope (shared with team via .mcp.json in project root)
claude mcp add --scope project network-sketcher -- python "/path/to/network-sketcher/network-sketcher_local_mcp/ns_mcp_server.py"

将 /path/to/network-sketcher/ 替换为克隆仓库的实际路径。有关各个作用域的详细信息及其适用场景，请参阅 Claude Code MCP 安装作用域文档。

用户指南（本地 MCP）

语言	链接
英语	链接
日语	链接

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Network Sketcher Online

**AI 原生软件：**Network Sketcher Online 围绕 AI（大模型）交互而设计——生成 AI 上下文，将其发送给大模型，再将返回的命令粘贴回来以更新网络设计，所有操作均可在浏览器中完成。

演示视频（Ver 3.0.1b）

一段约 4 分钟的演示视频，从安装 Network Sketcher 开始。视频演示了如何根据 URL 信息使用大模型创建网络配置，并进行后续编辑。无声音，无字幕。

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

什么是 Network Sketcher Online？

Network Sketcher Online 是一项基于浏览器的 Web 服务。它封装了 Network Sketcher CLI，并提供直观的 Web UI，用于生成图表和进行 AI 驱动的网络设计——无需在 PC 上安装 python。

在线功能

Network Sketcher Online 支持两种输出模式：

• SVG 模式（默认）：图表以 SVG 格式在浏览器中渲染。所有图表（L1/L2/L3、所有区域及各区域图表）都会并行生成，并以缩略图形式显示，无需逐个下载文件。主文件在内部以高性能 .nsm 格式存储。SVG 模式的速度约为 PPTX 模式的 30 倍。为兼容 Offline 版本，主文件也可以下载为 .xlsx 格式。

• PPTX 模式：图表以 PowerPoint（.pptx）文件形式生成，设备文件以 Excel（.xlsx）文件形式生成。这是原始输出模式，生成的文件与 Offline 版本相同。

• 会话结束后，所有上传和生成的文件都会从 Network Sketcher Online 自动删除——服务器不会保留任何数据。

• 在 Web 浏览器中通过拖放上传主文件

• 生成 L1/L2/L3 图表、设备文件和 AI 上下文文件，并可选择输出内容

• 多格式图表下载：SVG / SVG（用于 Visio）/ draw.io / draw.io（模具）——最后一种格式会自动应用 Cisco mxgraph.cisco.* 模具

• 无需 Office 软件，即可在浏览器中预览 PowerPoint（.pptx）和 Excel（.xlsx）文件

• 将 AI 上下文复制到剪贴板，并一键打开大模型

• 在提示词字段中描述所需更改；AI 上下文和提示词会一并复制，供大模型交互使用

• 通过粘贴大模型输出的 CLI 命令更新主文件（Update Master）

• 通过 Web UI 从头创建新的主文件

• 并行处理，加快图表生成速度

• 根据属性为 L1 和 L3 图表中的设备着色

• 浏览器刷新后保留会话，并自动清理

• 强制使用 HTTPS，并自动生成自签名证书

• 所有设置均通过 ns_web_config.json 管理

限制（在线版）

• 仅面向内部网络使用，不适用于部署到公共互联网。
• 支持 IPv4 和 IPv6。不接受或绘制 IPv6 链路本地地址（fe80::/10）、组播、环回、未指定、IPv4 映射和站点本地地址，以及区域索引表示法（%）。图表大小和间距不会针对较长的 IPv6 地址进行调整。
• Excel（.xlsx）和 PowerPoint（.pptx）文件无法同步回主文件。所有编辑均通过大模型生成的 CLI 命令完成。
• 当浏览器缩放或显示缩放比例较高（例如 200%）时，PowerPoint（.pptx）的浏览器内预览可能无法正确渲染。

要求（在线版）

• 仅在 Windows 上测试。 在 Mac OS 和 Linux 上可能可以运行，但尚未在这些平台上验证。
• 其他要求与 Network Sketcher Offline 相同。

安装（在线版）

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

在浏览器中打开启动时显示的 URL（默认值：https://localhost:5443）。

• 若要通过特定网络接口提供服务，请在启动服务前编辑 ns_web_config.json 中的 host 和 port 设置。
• 如果不存在 SSL 证书，首次启动时会自动生成自签名证书。
• 如果更改 ns_web_config.json 中的主机 IP 地址或其他设置，请手动删除 Certs/ 文件夹中的 SSL 证书文件，然后重启服务。系统会自动生成与更新后设置相匹配的新证书。
• 如果配置了 ns_web_config.json 中的 fqdn 设置，自动生成的 SSL 证书的通用名称（CN）将使用指定的 FQDN。

用户指南（在线版）

语言	链接
英语	链接
日语	链接

性能测量摘要（在线版）

版本：3.0.1（SVG 模式）	64 台网络设备 112 条连接	256 台网络设备 480 条连接	1024 台网络设备 1984 条连接	4096 台网络设备 8064 条连接
主文件创建 *1	4 秒	4 秒	26 秒	8 分 12 秒
创建所有配置图、设备表和 AI 上下文文件	3 秒	7 秒	58 秒	15 分 42 秒

---

*1 仅在 no_data 主文件中反映 L1 信息。连接相邻设备。测量命令执行时间。
测试环境：Intel Core Ultra 7（1.70 GHz），32.0 GB RAM，Windows 11 Enterprise

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Network Sketcher 离线版

概述

https://github.com/user-attachments/assets/9ff207f8-c6b3-4584-b166-98ae4e4c8297

NoLang（no-lang.com） Otologic（https://otologic.jp）CC BY 4.0

基本用法演示视频

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

AI（LLM）应用演示视频

完整版本链接（Youtube）

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

概念

Network Sketcher 可在 PowerPoint 中生成网络配置图，并在 Excel 中管理配置信息。此外，导出 AI 上下文后，可使用 LLM 生成配置文件。

• 通过将网络配置信息元数据化，自动生成各类配置文档
• 自动同步各文档
• 通过自动生成通用格式，尽量减轻维护和培训负担
• 通过将配置信息元数据化，促进自动分析、AI 应用和系统间协作。
• 支持设备配置模板

新功能（离线版）

• Ver 2.6.1
  Network Sketcher Ver 2.6.1 支持使用大模型从头创建网络配置

• Ver 2.6.0
  

Network Sketcher Ver 2.6.0 现在支持将 Visio、draw.io、NetBox 和 CML 数据转换为 Network Sketcher 主文件。

虽然 Network Sketcher 现在支持多种格式，但它并非旨在取代主要绘图工具，而是希望实现互利发展。

如需通过 API 导入平台数据，请参阅上文的扩展：Cisco 和第三方转换器（可与针对 Visio / draw.io / NetBox 文件的离线 GUI 导入功能互补）。

• Ver 2.5.0
  • 新增了通信流管理功能。

限制（离线版）

• 支持 IPv4 和 IPv6。不接受或绘制 IPv6 链路本地地址（fe80::/10）、多播地址、环回地址、未指定地址、IPv4 映射地址和站点本地地址，也不支持区域索引表示法（%）。图表大小和间距不会针对较长的 IPv6 地址进行调整。自动 IP 地址分配仅分配 IPv4 地址。
• 一个 DEVICE 文件包含多个工作表，但一次只能更新一个工作表。不支持同时同步多个工作表的更新。
• 请勿在 One Drive 文件夹中的主文件上使用 Network Sketcher。
• 使用 GUI 删除 Layer 1 链路时，无法识别单个接口，因此会删除超出预期的 Layer 2 数据。请使用 CLI 命令（delete l1_link）删除 Layer 1 链路。

要求（离线版）

• Network Sketcher 支持跨平台，可在 Windows、Mac OS 和 Linux 上运行。
  • MAC OS 在深色模式下可能无法正常显示。
• Python ver 3.x
• 可编辑 .pptx 和 .xlsx 文件的软件
  • Microsoft Powerpoint 和 Excel 是最佳选择
  • 可使用 Google Slides 和 Spreadsheets 的导入/导出功能。Excel 函数显示时会报错，但仍可正常使用。
  • 无法使用 Libre Office 和 Softmaker office。

安装（离线版）

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

安装补充说明（离线版）

• 可替代 "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 networkx
python3 -m pip install svg.path

• Mac OS 需要进行以下额外安装。

brew install tcl-tk
brew install tkdnd

• Ubuntu 需要进行以下额外安装。
  Ubuntu 上的 GUI 拖放功能无法使用；你需要从源代码编译 tkdnd，或使用 "Browse" 和 "Submit"。

sudo apt-get install python3-tk

用户指南（离线版）

语言	链接
英语	链接
日语	链接

如何使用 pyinstaller 为 Windows 创建 exe 文件

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;."

## 性能测量摘要（离线）

版本：2.6.1b	64 台 NW 设备 112 个连接	256 台 NW 设备 480 个连接	1024 台 NW 设备 1984 个连接
主文件创建 *1	51s	2m45s	25m45s
第 1 层图表生成（所有区域，含标签）	6s	29s	6m30s
第 2 层图表生成	13s	51s	6m53s
第 3 层图表生成（所有区域）	10s	56s	14m23s
导出设备文件	19s	1m4s	5m14s

---

*1 仅在 no_data 主文件中反映 L1 信息。连接相邻设备。测量命令执行时间。
测试环境：Intel Core Ultra 7（1.70 GHz），32.0 GB RAM，Windows 11 Enterprise

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

附录

功能支持矩阵

功能项	本地 MCP（由 LLM 驱动的 CLI）	在线版	离线版（GUI）	离线版（CLI）
根据 PowerPoint 草图创建主文件	❌	❌	✅	❌
转换 Visio / Draw.io / NetBox 文件（内置离线 GUI）	❌	❌	✅	❌
通过 Cisco 扩展 转换器导入（见上文）	✅	✅	✅	✅
放置 / 创建 / 删除 / 修改区域、设备、路径点	✅	✅	✅（在 GUI 中自动放置区域）	✅
添加 / 删除 / 修改第 1 层连接（端口名称、双工等）	✅	✅	⚠️（删除时无法指定端口）	✅
更改第 2 层网段（VLAN）/ 添加 / 删除虚拟端口（SVI、loopback、port-channel）	✅	✅	✅	✅
更改 IP 地址 / 第 3 层实例（VRF）	✅	✅	✅	✅
更改属性	✅	✅	✅	✅
添加 / 删除 VPN	❌	❌	✅	❌
流量管理	❌	❌	✅	❌
导出各类报告	✅（仅 IP 地址）	✅（仅 IP 地址）	✅	❌
导出空白主文件（无数据）	✅	✅	❌	✅
导出 AI 上下文文件	✅	✅	✅	✅
导出设备文件	✅	✅	✅	✅
生成 L1/L2/L3 拓扑图	✅	✅	✅	✅
将图表导出为 SVG（兼容 Visio）/ draw.io（含 Cisco 模板）	❌	✅	❌	❌

有关 Cisco 扩展导入的注意事项，请参阅上文的扩展：Cisco 和第三方转换器。

示例

- 支持多种连接

下载：Sample.figure5.zip

- Wi-Fi 办公室

使用 AI 上下文，并向 AI（LLM）提供多条命令生成指令创建。

下载：Sample Office.zip

---

_{Otologic (https://otologic.jp) CC BY 4.0}

作者

• Yusuke Ogawa - Cisco 架构师 | CCIE#17583

许可证

SPDX-License-Identifier: Apache-2.0

版权所有 2023 Cisco Systems, Inc. 及其关联公司

本文件根据 Apache License 2.0 版（以下简称“许可证”）授权； 除非遵守许可证，否则不得使用本文件。 您可以通过以下网址获取许可证副本：

http://www.apache.org/licenses/LICENSE-2.0

除非适用法律要求或书面同意，否则根据许可证分发的软件 均按“按原样”提供，不附带任何明示或默示的保证或条件。 有关许可证所规定的权限和限制，请参阅许可证。