PacketTracer-MCP-Enhanced

基于 Mats2208/MCP-Packet-Tracer 和 kimmknight/PTBuilder 二次优化。

AI 驱动的 Cisco Packet Tracer 自动化工具。通过 OpenCode + MCP 协议，用自然语言搭建网络拓扑、配置 OSPF/NAT/ACL、测试连通性。

目录

MCP-Packet-Tracer/       ← MCP 服务器（改版）
PTBuilder/               ← Builder Code Editor（二次优化版）
skills/packet-tracer/    ← AI 技能（自动加载，防猜错 API）
AGENTS.md                ← AI 记忆文件，放 ~/.agents/

快速开始

1. 安装 PTBuilder

① PTBuilder/PTBuilder.pts → 复制到 PT 安装目录的 extensions\ 文件夹
   (例如 D:\Program Files\Cisco Packet Tracer 8.2.2\extensions\)
② PT → Extensions → Scripting → Config PT Script Modules → Add → 选择 PTBuilder.pts
③ 重启 PT

⚠️ 不要删除 .pts 文件，否则 Builder Code Editor 会消失。

2. 安装 MCP 服务器

cd MCP-Packet-Tracer
pip install -e .

3. 配置 OpenCode

编辑 ~/.config/opencode/opencode.json：

{
  "mcp": {
    "packet-tracer": {
      "type": "local",
      "command": ["python", "-m", "packet_tracer_mcp", "--stdio"],
      "enabled": true,
      "env": { "PYTHONPATH": "/path/to/MCP-Packet-Tracer/src" }
    }
  }
}

4. 安装 AI 技能

cp -r skills/packet-tracer ~/.agents/skills/
cp AGENTS.md ~/.agents/AGENTS.md

5. 建立桥接

① PT → Extensions → Builder Code Editor
② 打开 MCP-Packet-Tracer/test_bootstrap.js → 全选复制 → 粘贴 → Run
③ OpenCode → "检查桥接状态"

优化内容

MCP 服务器

• 新增 6 个桥接函数：reportResult、deleteDevice、renameDevice、moveDevice、deleteLink、queryTopology
• 动态 bootstrap 生成，不再硬编码
• 增强 AI 系统指令：完整 API 参考 + 不存在函数黑名单 + 实战错误记录
• 工具描述修正：示例代码全部改为正确调用方式

AI 技能系统

• SKILL.md：自动加载，含 GOLDEN RULE、bootstrap 代码块、完整 API 参考、16 条实战错误
• AGENTS.md：持久记忆，记录已发现和已验证的 API

PTBuilder

• CodeMirror 5：语法高亮、行号、括号匹配
• 三态按钮：Running → Done / Error
• 桥接状态实时指示
• 修复多行脚本 Bug
• 自动保存

与 AI 对话示例

"从零搭建 3 台路由器 OSPF 拓扑，配静态 IP，最后 ping 通" "在 R1 上配 NAT 过载，让 LAN 的 PC 能访问外网" "在 R3 上配置扩展 ACL，只允许特定流量访问服务器"

相关项目

• MCP-Packet-Tracer — 原版 MCP 服务器
• PTBuilder — 原版 Builder Code Editor