内容
# eNSP Automation MCP
一个面向 eNSP 拓扑生成、VRP 配置下发和实验验收的 MCP 服务。
它能帮 agent 生成网络拓扑、输出华为 VRP 配置、批量下发配置，并给出验收命令和调试案例。定位很明确：**把 eNSP 里重复搭拓扑、重复写配置、重复整理验证命令这部分省下来。**
> 这不是华为官方工具，也不是 eNSP 官方插件。它是一个基于 `.topo` 工程生成 + Telnet/Console CLI 自动化的开源 MCP 项目。
## 现在能跑到什么程度
目前内置了两种校园网示例模板。它们不是万能模板，只是相对完整的起点：有分区、有路由、有出口、有服务、有安全策略，拿来做实验、录演示、整理验证证据都比较方便。
`showcase` 是默认模板，设备和连线更多，适合录屏展示和做一张看起来完整的拓扑图。它大概长这样：
- 6 个 VLAN：教师、学生、实验室、服务器、管理、访客。
- 30 多台设备，40 多条线，看起来像一个完整校园网，而不是两台交换机随便连一下。
- 接入口走 Access，交换机之间走 Trunk。
- 跨 VLAN 通信用 AR 子接口做。
- 路由部分用 OSPF area 0，出口再配一条默认路由。
- DHCP 地址池放在核心路由侧。
- DNS、Web、FTP 这三类服务会把地址和测试步骤写清楚。
- 出口有 NAT/PAT。
- ACL 做了两条比较典型的限制：
- 学生区不能访问管理区。
- 访客区不能访问校园内网，但能访问模拟外网。
- 生成验收用的命令、测试点和一个调试案例，方便后面截图写报告。
`standard` 是精简模板，保留关键网络功能，但设备数量和连线少很多，更适合答辩讲解、课堂演示和快速验证：
- 13 台设备，12 条线。
- 6 个 VLAN：教师、学生、实验室、服务器、管理、访客。
- 1 台 ISP 路由器、1 台出口路由器、1 台核心交换机、1 台接入交换机。
- DNS、Web、FTP 三台服务器和 5 类测试终端。
- 出口路由器负责跨 VLAN 网关、DHCP、静态默认路由、NAT/PAT 和 ACL。
## 重要限制
eNSP 和 Packet Tracer 不一样，没有稳定公开的 `addDevice/addLink` 画布控制接口。所以本项目采用更稳的路线：
1. 生成 `.topo` 拓扑工程。
2. 在 eNSP 里打开拓扑并启动设备。
3. MCP 扫描 eNSP 暴露的 Telnet/Console 端口。
4. MCP 批量下发 VRP 配置并保存。
有些 eNSP 版本不会稳定加载生成工程里的 `vrpcfg.zip`。如果打开设备还是 `<Huawei>`，不是项目失效，直接使用批量下发配置工具即可。
PC / Server 的 IP 和 DNS/Web/FTP 图形服务也不一定能由 `.topo` 稳定恢复，报告验收前建议手动确认。
## 快速安装
```powershell
git clone https://github.com/<your-name>/ensp-automation-mcp.git
cd ensp-automation-mcp
pip install -e . --no-deps --no-build-isolation
```
如果你本机已经能正常安装 MCP 依赖，也可以直接：
```powershell
pip install -e .
```
## MCP 客户端配置
通用 MCP JSON 配置示例：
```json
{
"mcpServers": {
"ensp-automation-mcp": {
"command": "ensp-automation-mcp",
"args": []
}
}
}
```
Codex 风格 TOML 配置示例：
```toml
[mcp_servers.ensp-automation-mcp]
command = "ensp-automation-mcp"
args = []
```
配置好后重启你的 agent / MCP 客户端。
## 工具列表
| 工具 | 用途 |
| --- | --- |
| `ensp_getCampusPlan` | 查看内置校园网方案 |
| `ensp_generateCampusProject` | 生成 `.topo`、配置、服务步骤、测试计划 |
| `ensp_generateCampusConfigs` | 输出所有 VRP 配置 |
| `ensp_getVerificationPlan` | 输出验收命令、业务测试、调试案例 |
| `ensp_scanTelnetPorts` | 扫描 eNSP 设备 Telnet/Console 端口 |
| `ensp_telnetConnect` | 连接单台 eNSP 设备 |
| `ensp_telnetExecute` | 在单台设备执行命令 |
| `ensp_telnetApplyConfig` | 给单台设备批量下发配置 |
| `ensp_applyCampusConfigsByPortRange` | 按默认端口映射一键下发整套校园网配置 |
| `ensp_saveCampusConfigsByPortRange` | 按默认端口映射一键保存整套校园网配置 |
| `ensp_telnetListSessions` | 查看当前 Telnet 会话 |
| `ensp_telnetDisconnect` | 断开 Telnet 会话 |
## 推荐使用流程
1. 调用 `ensp_generateCampusProject` 生成工程。默认是 `showcase`，需要精简版就传 `template: "standard"`。
2. 在 eNSP 中打开生成的 `.topo`。
3. 启动设备，建议分批启动：先路由器，再核心/汇聚交换机，再接入交换机，最后 PC/Server。
4. 调用 `ensp_scanTelnetPorts`，确认端口在线。
5. 调用 `ensp_applyCampusConfigsByPortRange` 批量下发配置。
6. 调用 `ensp_saveCampusConfigsByPortRange` 保存设备配置。
7. 调用 `ensp_getVerificationPlan`，按命令截图验收。
默认端口映射从 2000 开始：
```text
showcase:
AR-ISP 2000
AR-EDGE 2001
AR-CORE-A 2002
AR-CORE-B 2003
LSW-CORE1 2004
...
LSW-IOT-ACC 2019
standard:
AR-ISP 2000
AR-EDGE 2001
LSW-CORE 2002
LSW-ACCESS 2003
```
## 服务器手动服务项
如果 eNSP Server 图形服务没有自动恢复，请手动设置：
```text
SRV-DNS
IP: 192.168.40.10/24
Gateway: 192.168.40.1
DNS: On
www.campus.local -> 192.168.40.20
ftp.campus.local -> 192.168.40.30
SRV-WEB
IP: 192.168.40.20/24
Gateway: 192.168.40.1
HTTP: On
SRV-FTP
IP: 192.168.40.30/24
Gateway: 192.168.40.1
FTP: On
User: ftpuser / cisco
```
## 什么情况下适合用
如果你是在做这些事，这个项目会比较顺手：
- eNSP 网络实验，不想从零拖设备、写重复配置。
- 网络工程演示，需要一套看起来完整、配置也说得通的拓扑。
- 想让支持 MCP 的 agent 帮你生成拓扑、下发配置、列验收命令。
- 想研究 eNSP 工程文件和 VRP 配置自动化。
## 先说清楚哪些事它做不了
- 它不是用来管真实生产网络的。
- 它不是华为官方工具，eNSP 版本差异导致的问题只能尽量兼容。
- 它不能绕开 eNSP 自己的限制，比如 Server 图形服务有时还是要手动点。
- 它也不是“打开拓扑就百分百全自动恢复配置”。如果设备还是 `<Huawei>`，就走 Telnet 批量下发配置。
## 开发
```powershell
python -m py_compile (Get-ChildItem -Path .\src\ensp_automation_mcp -Filter *.py | ForEach-Object { $_.FullName })
python -c "from ensp_automation_mcp.tools import TOOLS; print(len(TOOLS)); print([t['name'] for t in TOOLS])"
```
## 许可证
MIT License. See [LICENSE](LICENSE).
