Packet Tracer (packet-tracer-mcp)

数据包跟踪器MCP服务器

MCP服务器，允许任何LLM（Copilot、Claude等）实时创建、配置、验证和部署完整的网络拓扑到Cisco Packet Tracer。

告诉它“用3个路由器、DHCP和OSPF为我构建一个网络”，服务器就会规划拓扑结构，验证一切，生成脚本和配置，并将其直接部署到PT中。

使用Python 3.11+、Pydantic 2.0+、FastMCP、流式HTTP构建。

特性

• 完整管道 --从单个提示中规划、验证、自动修复、生成和部署拓扑
• 实时部署 --通过HTTP网桥直接向Packet Tracer发送命令，无需复制粘贴
• 22个MCP工具 --涵盖从设备目录查询到实时拓扑操作的所有内容
• 双向CLI --从PT内部的路由器和交换机读回CLI输出
• 自动IP规划 --自动分配/24个局域网和/30个路由器间链路
• 验证+自动修复 --捕获15种错误类型并自动更正电缆、型号和端口
• 多种路由协议 --静态、OSPF、RIP，可生成完整配置
• 9拓扑模板 --单局域网、多局域网、星型、中心辐射、分支机构、路由器等

运作原理

┌─────────┐         ┌──────────────┐   HTTP    ┌──────────────┐  $se()  ┌──────────────┐
│   LLM   │  MCP    │  MCP Server  │  :54321   │  PTBuilder   │  IPC   │ Packet Tracer│
│(Copilot)│ ──────► │  (:39000)    │ ────────► │  (WebView)   │ ─────► │   (Engine)   │
└─────────┘         └──────────────┘           └──────────────┘        └──────────────┘

两个HTTP服务器同时运行：

MCP服务器规划拓扑，生成PTBuilder JavaScript+IOS CLI配置，并将其推送到网桥。PTBuilder的QWebEngine网络视图每500毫秒轮询一次网桥，并通过以下方式在PT的脚本引擎中执行命令 $se('runCode', ...).

______________________________________________________________________

设置

1.安装

git clone https://github.com/DavidIlie/packet-tracer-mcp.git
cd packet-tracer-mcp
pip install -e .

2.启动服务器

python -m src.packet_tracer_mcp

这将启动MCP服务器 0.0.0.0:39000 （局域网可访问）和HTTP网桥 127.0.0.1:54321 自动。

主机选择（按优先级顺序）：

• --host 127.0.0.1 标志--仅限本地主机
• PT_MCP_HOST env 是
• 违约： 0.0.0.0 （所有接口）

标准模式（调试/传统）： python -m src.packet_tracer_mcp --stdio

从局域网上的另一台机器连接

默认情况下，服务器绑定到所有接口。要从另一台笔记本电脑访问它：

1. 查找您的主机IP(ipconfig 在Windows上， ifconfig 在macOS/Linux上）——例如。， 10.1.0.7
2. 在Windows防火墙上打开端口39000（PowerShell作为管理员）：

   New-NetFirewallRule -DisplayName "packet-tracer-mcp" -Direction Inbound -LocalPort 39000 -Protocol TCP -Action Allow -Profile Private,Domain

1. 在远程计算机上，将MCP客户端指向 http://:39000/mcp 而不是 127.0.0.1.

HTTP网桥（端口54321）仅绑定到localhost——Packet Tracer与服务器运行在同一台机器上，因此不需要远程访问。

3.配置您的MCP客户端

克劳德代码：

claude mcp add --transport http packet-tracer http://127.0.0.1:39000/mcp

VS Code -- .vscode/mcp.json:

{
  "servers": {
    "packet-tracer": {
      "url": "http://127.0.0.1:39000/mcp"
    }
  }
}

克劳德桌面版 -- claude_desktop_config.json:

{
  "mcpServers": {
    "packet-tracer": {
      "url": "http://127.0.0.1:39000/mcp"
    }
  }
}

4.连接数据包跟踪器

1. 开放数据包跟踪器8.2+
2. 首选 扩展>生成器代码编辑器
3. 粘贴引导脚本并单击 跑:

/* PT-MCP Bridge */ window.webview.evaluateJavaScriptAsync("setInterval(function(){var x=new XMLHttpRequest();x.open('GET','http://127.0.0.1:54321/next',true);x.onload=function(){if(x.status===200&&x.responseText){$se('runCode',x.responseText)}};x.onerror=function(){};x.send()},500)");

这使得PTBuilder每500毫秒对桥梁进行一次轮询。当LLM生成命令时，MCP服务器将它们排队，PT实时执行它们。

注： 引导程序注入 setInterval 进入执行HTTP轮询的webview。 $se('runCode', ...) 从webview到PT脚本引擎的桥梁。PTBuilder executeCode() 在内部删除所有换行符，这就是引导程序使用 /* */ 评论而不是 //.

永久设置（可选）

要在Builder代码编辑器打开时自动启动轮询循环，请执行以下操作：

1. 在PT中：扩展>脚本接口
2. 选择生成器模块
3. 替换 main.js 和 interface.js 修改后的版本在 PTBuilder/source/
4. 保存并重新启动模块

5.完成

LLM现在可以自动创建设备、链接和配置路由器。让它建立一个网络。

______________________________________________________________________

MCP工具（22）

目录

估计

规划

验证

生成

完整管道

实时部署

拓扑交互

对于AI代理

看 代理商.md 获取实用指南，涵盖工具层、无声故障模式、规范IPC路径以及何时使用 pt_send_raw.

出口+项目

______________________________________________________________________

MCP资源（5）

______________________________________________________________________

支持的设备

路由器

开关

终端设备

其他

______________________________________________________________________

电缆类型

______________________________________________________________________

定址方式

• 局部区域网 -- 192.168.X.0/24，网关位于 .1，来自的PC .2
• 路由器间链路 -- 10.0.X.0/30，路由器之间的点对点
• 动态主机配置协议 --每个局域网的自动池，网关除外

路由

______________________________________________________________________

模板

______________________________________________________________________

建筑

src/packet_tracer_mcp/
├── adapters/mcp/              # MCP protocol layer
│   ├── tool_registry.py       # 22 MCP tools
│   └── resource_registry.py   # 5 MCP resources
├── application/               # Use cases + DTOs (requests/responses)
├── domain/                    # Core business logic
│   ├── models/               # TopologyPlan, DevicePlan, LinkPlan, errors
│   ├── services/             # Orchestrator, IPPlanner, Validator, AutoFixer
│   └── rules/                # Validation rules (devices, cables, IPs)
├── infrastructure/
│   ├── catalog/              # Device catalog, cables, templates, aliases
│   ├── generator/            # PTBuilder JS + CLI config generators
│   ├── execution/            # Executors + HTTP bridge
│   │   ├── live_bridge.py    # PTCommandBridge (HTTP server :54321)
│   │   ├── live_executor.py  # LiveExecutor (sends plan → bridge → PT)
│   │   ├── deploy_executor.py# DeployExecutor (clipboard + instructions)
│   │   └── manual_executor.py# ManualExecutor (file export)
│   └── persistence/          # Project save/load
├── shared/                    # Enums, constants, utilities
├── server.py                  # MCP server entry point
└── settings.py                # Version + config

数据流

TopologyRequest → Orchestrator → IPPlanner → Validator → AutoFixer
                                                            ↓
                                              TopologyPlan (validated)
                                                            ↓
                                    ┌───────────────────────┼──────────────────┐
                                    ↓                       ↓                  ↓
                            PTBuilder Script          CLI Configs        Live Deploy
                           (addDevice/addLink)    (hostname, IPs,     (HTTP bridge
                                                   DHCP, routing)      → PT real-time)

______________________________________________________________________

PTBuilder扩展

这 PTBuilder/ 目录包含脚本模块“生成器代码编辑器”的源代码：

______________________________________________________________________

测试

# All tests
python -m pytest tests/ -v

# Single file
python -m pytest tests/test_full_build.py -v

# Specific test
python -m pytest tests/test_full_build.py::TestFullBuild::test_basic_2_routers -v

34个测试，涵盖IP规划、验证、自动修复、解释、估计、生成和完整构建集成。

______________________________________________________________________

快速示例

User:  "Build me a network with 2 routers, 2 switches, 4 PCs, DHCP and static routing"

→ pt_full_build generates:
  - 8 devices: R1, R2, SW1, SW2, PC1, PC2, PC3, PC4
  - 7 links: R1↔R2 (cross), R1↔SW1 (straight), R2↔SW2 (straight), SW1↔PC1, SW1↔PC2, SW2↔PC3, SW2↔PC4
  - IPs: LAN1 192.168.0.0/24, LAN2 192.168.1.0/24, Inter-router 10.0.0.0/30
  - DHCP pools on R1 and R2
  - Bidirectional static routes
  - 23 JavaScript commands sent to PT

→ pt_live_deploy sends everything to Packet Tracer and the devices appear fully configured

需求

• Python 3.11+
• 思科数据包跟踪器8.2+（用于实时部署）
• PT中安装的PTBuilder扩展（包含在 PTBuilder/)

许可证

麻省理工学院