MCP 服务器

Packet Tracer Visual MCP

Enables automation of Cisco Packet Tracer simulations by placing devices, connecting links, and generating IOS configurations via MCP, ideal for network coursework and demonstrations.

README

Packet Tracer Visual MCP

这个项目是一个给 Packet Tracer 用的 MCP 工具。

说白了：以前你在 Packet Tracer 里要自己拖设备、连线、配路由、配 VLAN；现在可以让 Codex 通过 MCP 去干这些活。它特别适合计网课设、校园网实验、录屏演示、故障排查演示。

这个项目是独立实现，不是 Cisco 官方项目，也不冒充官方工具。

现在能做什么

读取 Packet Tracer 当前画布。
自动放设备，支持一台一台出现，录屏看起来比较直观。
自动连线，支持一条一条连。
自动分配端口，不用每条线都手写 FastEthernet0/1 这种接口。
内置一个中小型校园网模板：33 台设备，34 条链路。
自动生成完整 IOS 配置：
- VLAN
- Access / Trunk
- 跨 VLAN 通信
- 静态路由 / RIP / OSPF / EIGRP
- DHCP
- ACL
- NAT/PAT
可以把 IOS 配置直接下发到 Packet Tracer 设备。
支持故障注入和修复演示，比如 OSPF 区域错误、ACL 误拦截、NAT 配错。
默认有 fast 快速验收，不会一上来跑一大堆慢 show 命令。
也能生成标准验收计划，适合最后交课设前慢慢查。

一行安装

目前还没发到 PyPI，所以先用 GitHub 安装最稳：

git clone https://github.com/lyf94697-droid/packet-tracer-visual-mcp.git; cd packet-tracer-visual-mcp; python -m pip install -e .; python scripts\build_script_engine.py

然后把 MCP 配到 Codex：

[mcp_servers.packet-tracer-visual-mcp]
command = "pt-visual-mcp"
args = []

启动 MCP：

pt-visual-mcp

Packet Tracer 里怎么接上

先生成扩展脚本：

python scripts\build_script_engine.py

然后在 Packet Tracer 里导入并运行：

extension\packet-tracer-visual-mcp-script-engine.js

接着打开：

Extensions > PT Visual MCP

窗口里显示 connected 就说明接上了。

默认连接地址是：

ws://127.0.0.1:7541/ws

计网课设能覆盖到哪

内置校园网模板就是按常见计网课设来做的：

至少 4 个 VLAN：支持，默认有 VLAN 10/20/30/40/50/99。
Access / Trunk：支持。
跨 VLAN 通信：支持。
静态路由或 OSPF：支持，还额外支持 RIP 和 EIGRP。
DHCP：支持 IOS DHCP 池，也可以做 DHCP relay 方案。
DNS / Web / FTP：服务器位置和地址规划支持，服务开关见下面说明。
NAT/PAT：支持。
ACL：支持，默认有两条允许/拒绝验证案例。
连通性测试、服务测试、NAT 测试、ACL 测试：会自动生成测试清单。
完整调试案例：支持，比如“VLAN30 不能访问 Web，但 DNS 正常”。

Server-PT 图形服务说明

网络侧我已经能自动做：IP、网关、DNS、VLAN、路由、ACL、NAT/PAT 都可以走 MCP。

但 Packet Tracer 的 Server-PT > Services 面板比较特殊。DNS、HTTP、FTP 这些开关和用户添加，取决于 Packet Tracer Script Engine 有没有暴露稳定 API。

所以当前最稳的做法是：

SRV-DNS：Services > DNS > On
- www.campus.local -> 192.168.40.20
- ftp.campus.local -> 192.168.40.30
SRV-WEB：Services > HTTP > On
SRV-FTP：Services > FTP > On
- 用户：ftpuser
- 密码：cisco

后续可以做一个实验功能：

先用 ptv_probeServerServices 探测 Server-PT 设备对象到底暴露了哪些服务相关方法。
如果有稳定 API，就加 ptv_configureServerServices，自动开 DNS/HTTP/FTP。
如果没有稳定 API，就不硬吹自动化；最多提供手动步骤或非默认的 GUI 点击方案。

已经提供的探测工具：

ptv_probeDeviceApi：只读探测任意设备对象暴露了哪些方法。
ptv_probeServerServices：只读扫描 Server-PT 上 DNS/HTTP/FTP/DHCP 相关的方法线索。

这两个工具不会改服务配置，只负责判断有没有稳定接口。

常用 MCP 工具

基础操作：

ptv_bridgeStatus
ptv_getNetwork
ptv_addDevice
ptv_addDevicesTimeline
ptv_addLink
ptv_addLinksTimeline
ptv_configurePc
ptv_configureIos

校园网和配置：

ptv_getCampusPlan
ptv_buildCampusRecordingDemo
ptv_generateCampusIosConfig
ptv_applyCampusIosConfig
ptv_generateIosTemplate
ptv_applyIosConfigSet

验收和排错：

ptv_validateCampusFast
ptv_generateCampusValidationPlan
ptv_getCommandLog
ptv_runShowCommands
ptv_probeDeviceApi
ptv_probeServerServices
ptv_getFaultLibrary
ptv_injectFault
ptv_repairFault

快速录屏推荐参数

想要“看起来很快，但别乱掉”，推荐：

{
  "qualityMode": "fast-safe",
  "deviceDelayMs": 40,
  "linkDelayMs": 20,
  "autoAssignPorts": true,
  "autoFallback": true,
  "validatePlan": true,
  "verifyAfterBuild": true,
  "configureDevices": false
}

如果要顺手下发配置，把 configureDevices 改成 true，但会比单纯摆拓扑慢。

验收模式

fast：默认模式。看拓扑是否建全、构建有没有失败、关键设备和链路是否存在。不跑重型 show 命令。
standard：生成 VLAN、Trunk、路由、DHCP、NAT、ACL 的命令检查计划。
strict：更适合最后交付前慢慢验。
off：不验收。

录屏和快速生成用 fast，答辩前再用 standard 或 strict。

示例

课程设计示例看这里：

examples/campus-course-design.md

常用提示词看这里：

examples/prompts.md

本地自检

python -m pip install -e .
python scripts\check_project.py
python -m compileall src scripts
python scripts\build_script_engine.py
node --check extension\source\pt_api.js
node --check extension\source\interface\bridge.js
node --check extension\packet-tracer-visual-mcp-script-engine.js

自检通过时会看到类似：

project check passed: 23 tools, 33 devices, 34 links

项目结构

packet-tracer-visual-mcp/
  src/pt_visual_mcp/         MCP 服务端和 WebSocket 桥接
  extension/source/          Packet Tracer 扩展源码
  extension/*.js             可导入 Packet Tracer 的脚本
  skill/SKILL.md             Codex 技能说明
  examples/                  示例提示词和课设示例
  docs/                      功能说明和开发笔记
  scripts/check_project.py   项目自检脚本