Packet Tracer MCP

允许 Claude Code 通过自然语言在 Cisco Packet Tracer 中构建和配置拓扑的 MCP 服务器：创建设备、布线、应用 IOS 命令、VLAN、OSPF、NAT、ACL、VoIP，或根据图表图片复现整个网络。

Tu -> Claude Code --stdio--> mcp_server.py --HTTP--> bridge :54321
                                                         |
                              Packet Tracer  <-----------+
                              modulo Builder:
                                bridge.js         (pagina: hace el polling)
                                bridge_runner.js  (motor: ejecuta y devuelve)

HTTP 桥接运行在 MCP 服务器内部：无需单独打开终端来启动它。轮询循环位于 Builder 模块内部：也无需在 Packet Tracer 中粘贴任何内容。

要求

Related MCP server: packet-tracer-mcp

启动（仅一次）

1. 依赖项

uv sync

2. 在 Packet Tracer 中安装 Builder 模块

packet_tracer/Builder.pts 是脚本模块，它在 PT 内部定义了本项目使用的函数（addDevice、addLink、addModule、configureIosDevice、configurePcIp、getDevices、removeLink、addLabel、saveTopology）以及将其与 HTTP 桥接通信的桥梁。 没有此模块，一切都不起作用。

在 Packet Tracer 中（菜单为英文，已在 PT 9.0.0 中验证）：

1. Extensions -> Scripting -> Configure PT Script Modules

2. Add -> 选择本仓库中的 packet_tracer/Builder.pts

3. 在列表中选择 Builder -> Settings -> 勾选 On Startup，以便每次打开 PT 时模块自动启动

4. 确认其正在运行：在 Extensions 菜单中应出现 Builder Code Editor 条目。如果没有出现，则模块未启动。

启动时，模块会自动打开 Builder Code Editor 窗口。该窗口承载轮询循环，因此工作时必须保持打开；如果其标题显示“bridge activo”，则桥接正在工作。

3. 在 Claude Code 中打开项目

在终端中，进入项目文件夹：

claude

Claude Code 读取 .mcp.json 并自动启动 MCP 服务器（以及其中的 HTTP 桥接）。第一次可能会要求你确认信任该文件夹。

要检查服务器是否已连接，请在 Claude Code 中输入 /mcp：应出现 packet-tracer 及其工具。

日常使用

1. Abre Packet Tracer
   -> la ventana "Builder Code Editor" se abre sola y debe quedarse abierta

2. En una terminal, en la carpeta del proyecto:
      cd ruta/al/pt_MCP
      claude

3. Dentro de Claude Code:
      /pt-iniciar     -> confirma que las 3 piezas responden

无需启动其他任何东西：既不需要 main.py，也不需要向 Packet Tracer 粘贴脚本，更不需要额外的终端。

然后，用自然语言：

• “创建两台 2911 路由器，通过串口连接，使用 10.0.0.0/30，每台 LAN 中有一台 PC”

• /pt-desde-imagen diagramas/ejemplo-red1.jpeg — 根据图表图片复现拓扑

• “在 SW1 上配置 VLAN 10 VENTAS，并将端口 1-4 设为 access”

如果画布上没有出现某些内容，请让 Claude 调用 verificar_entorno()：它会告诉你三个部分中哪个已宕机以及如何启动它。

结构

packet_tracer/ 中的两个 .js 已包含在 Builder.pts 中；它们单独放在仓库中是为了便于阅读、版本控制，并在需要时重新导入。

uv run python main.py 仍然可用于单独启动桥接，无需 MCP（这正是那些调试脚本所需要的）。

命令如何传输

1. Claude 调用 MCP 工具，该工具将其转换为一行 PT 的 JS 代码。

2. mcp_server.py 通过 POST /add_command 将其排队。

3. bridge.js（在 Builder Code Editor 窗口内）通过 GET /next_command（每 2 秒）获取它，并调用 $se('runCodeBridge', codigo)。

4. bridge_runner.js 在脚本引擎中执行它，如果返回一个值，则通过 evaluateJavaScriptAsync 将其返回给页面。

5. 页面通过 POST /command_result 发布它，mcp_server.py 接收它。

第 4 步是必需的，因为 $se() 只确认它已分派调用（解析为 true），从不返回所执行代码的值。

每个查询都包裹在唯一标记（a1b2c3d4|...）中，并且只接受带回该标记的结果。否则，迟到的响应会留在队列中，下一个查询会收到错误的响应。

已知限制

• Packet Tracer 不暴露 IOS 命令的输出：hacer_ping() 和 obtener_tabla_routing() 会发送命令，但其输出只能在 PT 内的设备控制台中看到。通过 API 的查询（getDevices()、端口状态）确实返回数据。

• crear_dispositivo()、conectar_dispositivos()、agregar_modulo_router() 和 eliminar_conexion() 会确认实际结果（[OK] / [ERROR]）。其余写入命令（IOS 配置）在排队时没有确认：Exito: Comando enviado 表示已排队，而非已执行。

• 创建某些设备时，PT 会自动在画布上添加一个 Power Distribution Device0。它会出现在清单中，这不是错误。

• obtener_puertos_dispositivo() 读取 PT 中设备的实际端口，包括已安装卡上的端口，并说明哪些是空闲的。

• diagnosticar_red() 看不到 802.1Q 子接口、VLAN 或路由表：它不报告故障并不能保证连通性。

• Builder Code Editor 窗口必须保持打开：它是循环所在的位置。