Metadata-Version: 2.1
Name: ensp-nexus
Version: 0.2.2
Summary: A safe, user-friendly MCP and web control plane for Huawei eNSP
Author: NetOpt
License: BSL-1.1
Requires-Python: >=3.11
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.11
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/ensp-nexus
Description-Content-Type: text/markdown

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

# eNSP Nexus

eNSP Nexus 是一个面向 AI 时代网络工程师培养的 Huawei eNSP 实验控制平面。
它把 eNSP 模拟器、Web 终端与 MCP（Model Context Protocol）工具统一在一个
工作区中，让人工智能助手能够直接参与网络实验的配置、验证与排障流程，
让学习者把精力集中在协议理解与架构思考，而不是重复的命令录入。

## 设计理念

- **AI 协同学习**：通过 MCP 协议向 AI 助手暴露结构化的拓扑、配置与会话状态，
  使其能够辅助配置下发、错误诊断和实验复盘。
- **安全优先**：内置危险命令拦截、操作审计、配置快照与防抖刷新机制，
  避免误操作破坏实验环境。
- **原生级终端体验**：基于 WebSocket 透明转发的字符级 Web 终端，键入体验
  对标专业终端工具（Tab 补全、密码不回显、分页交互等）。

## 主要功能

- 导入 eNSP 实验文件夹，自动解析拓扑与设备 Console 端口
- 多设备共享会话的 Web 原生终端
- 配置快照管理（imported / live / stale 三态）
- MCP 工具集：设备发现、配置采集、命令执行、排障辅助
- 危险命令拦截与操作审计日志

## 部署方法

### 环境要求

- Python 3.11 或更高版本
- Windows 操作系统（需运行 eNSP 模拟器）
- 已安装并运行 Huawei eNSP

### 安装

```bash
pip install ensp-nexus
```

### 启动 Web 控制台

```bash
ensp-nexus-api
```

启动后访问控制台地址（默认 http://127.0.0.1:8000），导入 eNSP 实验文件夹
即可开始使用。

### 作为 MCP Server 接入 AI 助手

在支持 MCP 的客户端（如 Claude Desktop、Cursor 等）配置文件中添加：

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

### 健康检查

```bash
ensp-nexus-doctor
```

## License

Business Source License 1.1（个人与教育用途免费，2029-01-01 起转为 Apache 2.0）。

## 相关链接

- 主页：https://github.com/quwentao2005/ensp-nexus
- MCP Registry：https://registry.modelcontextprotocol.io
