Metadata-Version: 2.1
Name: ensp-nexus
Version: 0.2.4
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

## 为什么做这个项目

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

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

## 主要功能

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

## 部署要求

- Windows 10 或 Windows 11
- Huawei eNSP
- Node.js 22 或更高版本
- [uv](https://docs.astral.sh/uv/getting-started/installation/)

## 安装

在 PowerShell 中执行：

```powershell
uv tool install --python 3.12 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 实验文件夹，查看拓扑、连接设备并开始实验。

## 更新

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

## 项目主页

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

