eNSP Nexus

为什么做这个项目

在 AI 时代，网络数通学习不应该继续把大量时间消耗在重复录入命令、来回切换窗口和人工整理配置上。

eNSP Nexus 希望把 Huawei eNSP 实验、网络拓扑、设备配置、交互终端和 AI 助手连接起来，形成一套更高效、更直观的数通学习环境。AI 可以帮助学习者理解现象、分析配置、定位问题和复盘实验，而学习者可以把更多精力放在协议原理、网络设计与排障思路上。

主要功能

• 导入完整 eNSP 实验文件夹，展示实验拓扑、设备、链路和接口信息。
• 自动关联拓扑设备与配置文件，方便查看、搜索和比较设备配置。
• 提供浏览器中的设备终端和多设备操作界面，适合一边查看拓扑一边完成配置。
• 通过 MCP 接入 AI 助手，让 AI 读取拓扑和配置、辅助排障、执行实验操作并解释判断过程。
• 保存配置快照和操作记录，便于回顾配置过程与问题变化。
• 建立本地排障知识库，集中阅读 AI 生成的排障经验和个人 Markdown 笔记。
• 设备刷新配置时如需登录，会在界面中提示输入账号密码，登录成功后自动保存为本机绑定凭据，之后自动登录，无需重复输入。
• 默认在本机运行，适合个人学习、课程实验和认证训练环境。

部署要求

• Windows 10 或 Windows 11
• Huawei eNSP
• CPython 3.12（64 位）
• Node.js 22 或更高版本
• uv

安装（国内源）

以下安装步骤使用国内镜像下载，避免访问国外源网络不通的问题。

1. 安装 CPython 3.12

打开浏览器访问华为云 Python 镜像目录，下载 Python 3.12 的 Windows 安装包（python-3.12.x-amd64.exe）：

https://mirrors.huaweicloud.com/python/

进入 3.12.x 目录，下载最新的 64 位安装包并安装。安装时勾选 “Add python.exe to PATH”，其余选项保持默认。

安装完成后，打开 PowerShell 确认版本：

py -3.12 --version

2. 通过清华镜像安装 uv

uv 是用 Python 写的工具，可以直接用 pip 配合清华源安装：

pip install uv -i https://pypi.tuna.tsinghua.edu.cn/simple

安装完成后，确认版本：

uv --version

3. 从 npmmirror 镜像下载 Node.js 22+

打开 npmmirror 的 Node.js 镜像目录，下载 Node.js 22.x 的 Windows MSI 安装包并安装：

https://npmmirror.com/mirrors/node/

进入 v22.xx.x 目录，下载 node-v22.xx.x-x64.msi，一路默认安装即可。安装完成后确认版本：

node -v
npm -v

4. 安装 eNSP Nexus（指定清华源）

使用 uv 安装 eNSP Nexus，并通过 --default-index 指定使用清华 PyPI 镜像：

uv tool install --python 3.12 --default-index https://pypi.tuna.tsinghua.edu.cn/simple ensp-nexus

安装完成后，MCP 客户端使用以下配置：

{
  "mcpServers": {
    "ensp-nexus": {
      "command": "ensp-nexus"
    }
  }
}

如果 MCP 客户端找不到 ensp-nexus，请执行：

uv tool update-shell

然后重新启动 MCP 客户端。

开始使用

完成 MCP 配置后，可以直接对 AI 说：

请启动并打开 eNSP Nexus Web 控制台。

AI 会调用 nexus_start_web_console 启动本地服务并打开：

http://localhost:3000

进入工作台后即可导入 eNSP 实验文件夹，查看拓扑、连接设备并开始实验。之后你可以一边看拓扑，一边让 AI 帮你读配置、分析现象、排障代码和解释每一步。

更新

uv tool upgrade ensp-nexus

写在最后

数通这条路并不轻松，路由协议、VLAN、VXLAN、EVPN 这些概念一眼望不到头，刷题也总会有记不住的时候。但只要你一天一天地积累，一道题一道题地啃下来，那些曾经看不懂的报文，一定会慢慢变成你胸有成竹的判断。

坚持下去，你也能成为那个随手就能讲清楚网络三层架构、排障思路清晰的人。加油，未来的网络工程师！

项目主页

GitHub：quwentao2005/mcp_dev