Open Source — MIT License

AI-Powered Network
Troubleshooting

Let an autonomous AI agent diagnose and fix your Cisco Packet Tracer networks in real-time. Build labs, inject faults, and watch AI find the root cause — all through MCP.

npm
npx -y @ankitrajput07/packet-tracer-mcp
R1 Router SW1 Switch SW2 Switch PC1 PC2 PC3 PC4
🔍
Root Cause Found PC3 Gateway → 192.168.20.254 ✗
0+ MCP Tools
0 Source Files
0KB Package Size
MIT License

Everything Your AI Network
Engineer Needs

From building topologies to diagnosing multi-fault scenarios — all through natural language.

Auto Diagnosis

AI inspects live topology, reads device configs, checks VLANs, pings endpoints, and identifies the exact root cause — all autonomously.

AI Troubleshooting
▶ pt_inspect_ports --device SW1
FastEthernet0/2 → VLAN 20 ⚠️
▶ pt_apply_switching VLAN 1
✓ Fixed: Fa0/2 → VLAN 1
▶ pt_ping PC1 → PC2
✓ 4/4 replies, 100% success

Live Topology Control

Add routers, switches, PCs. Create links. Configure IPs. All through natural language commands to AI.

Instant Fix

AI makes the minimum necessary change. No rebuilding. No guesswork. Evidence-based repair with verification.

60+ MCP Tools

VLAN config, OSPF/EIGRP/BGP routing, ACLs, NAT, VoIP, QoS, IPv6, Wireless — everything Cisco, all via AI.

Fault Injection

Introduce controlled faults (wrong gateway, VLAN mismatch) and test your AI agent's troubleshooting ability.

How It Works

Three components connected through the Model Context Protocol (MCP).

🤖

AI Agent

Antigravity / Claude / ChatGPT

Thinks & Decides
MCP Protocol
⚡

MCP Server

@ankitrajput07/packet-tracer-mcp

Translates & Executes
IPC Bridge
🖧

Cisco Packet Tracer 9

Live Network Simulation

Simulates Hardware
01

You Describe the Problem

"PC1 cannot communicate with PC2" — just tell the AI in natural language what's wrong.

02

AI Inspects the Live Network

The AI calls MCP tools like pt_inspect_ports, pt_read_vlans, pt_ping to gather real evidence from Packet Tracer.

03

AI Identifies Root Cause

By analyzing the evidence (not guessing), AI determines the exact fault — wrong VLAN, bad gateway, missing route.

04

AI Applies Minimum Fix

One precise configuration change. No rebuilding. AI uses pt_apply_switching, pt_set_pc, or pt_run_cli_bulk to repair.

05

AI Verifies the Fix

Ping tests confirm connectivity. AI doesn't claim success without proof. 100% evidence-based.

Set Up in 2 Minutes

Three prerequisites. One config line. That's it.

Prerequisites

1

Cisco Packet Tracer 9

Download free from Cisco NetAcad. Enable the MCP Bridge extension inside PT.

2

Bun Runtime

Install from bun.sh. A fast JS runtime that runs the MCP server.

3

AI Agent (Any MCP Client)

Antigravity IDE, Claude Desktop, Cursor, or any MCP-compatible AI agent.

Configuration

Add this to your AI agent's mcp_config.json:

mcp_config.json
{
  "mcpServers": {
    "packet-tracer": {
      "command": "bun",
      "args": ["x", "-y",
        "@ankitrajput07/packet-tracer-mcp"]
    }
  }
}
💡 Restart your AI agent after saving. Bun will auto-download the package.

Watch AI Fix a Network

A real multi-fault troubleshooting session captured from Packet Tracer.

Fault Injected
🔴

Two Faults Active

  • PC3 gateway → 192.168.20.254 (wrong)
  • SW1 Fa0/2 → VLAN 20 (should be VLAN 1)
PC2 → PC1: 100% LOSS ✗
PC3 → PC1: 100% LOSS ✗
AI Diagnoses
AI Analysis
🔍

Evidence Found

  • ipconfig PC3: gateway 192.168.20.254
  • R1 Gi0/0/1 actual IP: 192.168.20.1
  • SW1 Fa0/2 in wrong VLAN
AI Fixes
Fixed ✓
🟢

Both Faults Repaired

  • PC3 gateway → 192.168.20.1
  • SW1 Fa0/2 → VLAN 1
PC2 → PC1: 100% SUCCESS ✓
PC3 → PC1: 100% SUCCESS ✓

Powerful Tool Categories

60+ tools covering every aspect of Cisco networking.

🏗️

Topology

add_device, create_link, delete_device, auto_layout, query_topology

🔌

Switching

apply_switching, read_vlans, inspect_ports, manage_clusters

🌐

Routing

OSPF, EIGRP, BGP, RIP, Static routes, HSRP, advanced_routing

🔒

Security

read_acl, port_security, NAT, firewall rules

📡

Services

DHCP, DNS, VoIP, QoS, IPv6, Wireless, subinterfaces

🧪

Testing

ping, traceroute, show_running, simulation_mode, send_pdu

Ready to Let AI
Manage Your Network?

Install the npm package, connect to Packet Tracer, and start building.