Metadata-Version: 2.1
Name: ensp-nexus
Version: 0.2.8
Summary: AI-assisted Huawei eNSP learning and operations workspace
Author: NetOpt
License: BSL-1.1
Requires-Python: >=3.12,<3.13
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Education
Classifier: Intended Audience :: Information Technology
Classifier: Operating System :: Microsoft :: Windows
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: System :: Networking
Requires-Dist: cryptography>=43.0
Requires-Dist: fastapi>=0.115
Requires-Dist: mcp[cli]>=1.26,<2
Requires-Dist: pydantic>=2.10
Requires-Dist: python-multipart>=0.0.18
Requires-Dist: uvicorn[standard]>=0.34
Project-URL: Homepage, https://github.com/quwentao2005/mcp_dev
Description-Content-Type: text/markdown

<!--
mcp-name: io.github.quwentao2005/ensp-nexus
-->

# eNSP Nexus

**“雄关漫道真如铁，而今迈步从头越。”**

学网络，从来都不是一条坦途。VLAN、路由、VXLAN、EVPN，一道道横在面前的雄关，你要一座一座地跨过去。这个项目，就是为你搭起的山间栈道与行军地图——让 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](https://docs.astral.sh/uv/getting-started/installation/)

## 安装（国内源）

以下安装步骤使用国内镜像下载，避免访问国外源网络不通的问题。磨刀不误砍柴工，先把工具备齐，学习才能如虎添翼。

### 1. 安装 CPython 3.12

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

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

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

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

```powershell
py -3.12 --version
```

### 2. 通过清华镜像安装 uv

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

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

安装完成后，确认版本：

```powershell
uv --version
```

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

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

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

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

```powershell
node -v
npm -v
```

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

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

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

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

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

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

```powershell
uv tool update-shell
```

然后重新启动 MCP 客户端。

## 开始使用

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

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

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

```text
http://localhost:3000
```

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

## 更新

```powershell
uv tool upgrade ensp-nexus
```

## 问题反馈

如果在使用中发现任何问题或报错，欢迎通过 QQ 反馈：**1011359990**。

**“把别人的经验变成自己的，是一种本事。”** 你的每一条反馈，都是让这个工具更进一步的一块基石——众人拾柴火焰高，问题不怕多，就怕没人说。我们一起把这条路修得更好走。

## 写在最后

**“世上无难事，只要肯登攀。”**

数通这条路，没有捷径，但也真的没有过不去的坎。今天背不下的路由协议，明天多捋一遍也就顺了；今天排不出的故障，明天换条思路也许就豁然开朗。别怕慢，**“星星之火，可以燎原”**——你每天划下的一笔笔记、敲下的一条命令，都在为日后的信手拈来积蓄力量。

还记得那句话吗——**“学习的敌人是自己的满足”**。拿到一个实验不要只满足于配通，多问一句“为什么”，多验证一层现象；**“谦虚使人进步，骄傲使人落后”**，保持空杯，才能装得下更多的真知。

当你某一天能独自站在拓扑图前，把三层架构讲得清清楚楚、把故障一针见血定位出来的时候，你会明白：原来的跋山涉水，都化作了**“踏遍青山人未老，风景这边独好”**的从容。

加油，未来的网络工程师。越过这道雄关，前面自有辽阔天地。

## 项目主页

[GitHub：quwentao2005/mcp_dev](https://github.com/quwentao2005/mcp_dev)