cisco-pt-mcp 🚀

KI-gestützte Cisco Packet Tracer Automatisierung - Lassen Sie KI-Clients Packet Tracer mit natürlicher Sprache steuern. Open-Source-MCP-Server mit Gemini-KI-Integration.

✨ Funktionen

• 🤖 KI-Netzwerkgenerierung - Beschreiben Sie Netzwerke in einfachem Englisch und erhalten Sie funktionierende Topologien

• 🎨 Visuelle Builder-Oberfläche - Webbasierter Code-Editor mit Syntaxhervorhebung

• 📦 Vorgefertigte Vorlagen - Konfigurationen für Campus, Zweigstellen, VLAN und Routing

• 🔌 MCP-Protokoll - Funktioniert mit Claude Desktop, Cursor und anderen MCP-Clients

• ⚡ Echtzeitsteuerung - Direkte Brücke zu einer laufenden Packet-Tracer-Instanz

• 🛠️ Vollständiges Werkzeug-Set - 20+ Tools für Geräteverwaltung, Konfiguration und Tests

Related MCP server: packet-tracer-mcp

📥 Schnellinstallation

1. MCP-Server installieren

# Clone or download this repository
cd cisco-pt-mcp

# Install with AI support
pip install -e ".[ai]"

# Configure Gemini API (optional, for AI features)
python setup_config.py

2. Packet Tracer-Erweiterung installieren

1. Öffnen Sie Cisco Packet Tracer

2. Klicken Sie auf Erweiterungen → Skripte → PT-Skriptmodule konfigurieren

3. Klicken Sie auf Hinzufügen → Wählen Sie extension/cisco-pt-mcp.pts

4. Starten Sie Packet Tracer neu

3. Starten & Verbinden

# Start the MCP server
python -m mcp_server

In Packet Tracer:

• Klicken Sie auf Erweiterungen → Packet Tracer MCP

• Der Status sollte "MCP Connected" anzeigen

📖 Ausführliche Anweisungen finden Sie in QUICKSTART.md

🎯 Nutzungsarten

Modus 1: KI-Generator (natürliche Sprache)

Öffnen Sie die PTBuilder-Oberfläche in Packet Tracer und verwenden Sie die KI-Generator-Registerkarte:

"Create a corporate network with 1 edge router, 1 core switch, 
2 department switches, and 3 PCs per department. Configure VLANs."

Klicken Sie auf Generieren → Das Netzwerk erscheint im Arbeitsbereich!

Modus 2: Code-Editor (JavaScript)

Schreiben Sie direkt PTBuilder-Code:

addDevice("R1", "2911", 150, 150);
addDevice("S1", "2960-24TT", 350, 150);
addLink("R1", "GigabitEthernet0/0", "S1", "GigabitEthernet0/1", "straight");
configureIosDevice("R1", "interface Gi0/0\nip address 192.168.1.1 255.255.255.0");

Modus 3: MCP-Client (Claude/Cursor)

Konfigurieren Sie Ihren MCP-Client:

Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "cisco-pt-mcp": {
      "command": "python",
      "args": ["-m", "mcp_server"],
      "cwd": "/path/to/cisco-pt-mcp",
      "env": {
        "GEMINI_API_KEY": "your_key_here"
      }
    }
  }
}

Chatten Sie dann mit Claude:

"Erstellen Sie ein Netzwerklabor zum Testen des OSPF-Routings mit 3 Routern"

🛠️ Verfügbare Werkzeuge

KI-gestützte Werkzeuge

Kernnetzwerk-Werkzeuge

Tabelle (2 Spalten)

Konfigurationswerkzeuge

Überwachungs- & Simulationswerkzeuge

📚 Dokumentation

• QUICKSTART.md - In 5 Minuten startbereit

• SETUP_GUIDE.md - Vollständige Einrichtungs- und Bedienungsanleitung

• packet-tracer-automation-build-doc.md - Erweiterte Automatisierungstechniken

🎓 Beispiele

Beispiel 1: Einfaches Netzwerk mit KI

Prompt: "Create a basic network with one 2911 router, one 2960 switch, 
and two PCs. Configure the router with IP 192.168.1.1 and the PCs 
with static IPs in the same subnet."

Result: Complete working network in 30 seconds

Beispiel 2: Campus-Netzwerk-Vorlage

Laden Sie die Vorlage „Campus Network“ aus der Registerkarte Vorlagen:

• 3-Stufen-Architektur (Kern, Distribution, Access)

• 1 Core-Switch

• 2 Distribution-Switches

• 4 Access-Switches

• Korrekte Verbindungen zwischen den Switches

Beispiel 3: VLAN-Konfiguration

// From templates - VLAN setup
addDevice("S1", "2960-24TT", 300, 200);
addDevice("PC1", "PC-PT", 150, 300);
addDevice("PC2", "PC-PT", 450, 300);

configureIosDevice("S1", `
vlan 10
name Sales
vlan 20
name Engineering

interface FastEthernet0/1
switchport mode access
switchport access vlan 10

interface FastEthernet0/2
switchport mode access
switchport access vlan 20
`);

🔧 Konfiguration

Einrichtung der Gemini-API

Option 1: Interaktiv

python setup_config.py

Option 2: Umgebungsvariable

export GEMINI_API_KEY="your_key_here"

Option 3: Konfigurationsdatei

Erstellen Sie ~/.cisco-pt/mcp/config.json:

{
  "gemini_api_key": "YOUR_KEY_HERE",
  "bridge_host": "127.0.0.1",
  "bridge_port": 7531,
  "tool_timeout": 60
}

🏗️ Architektur

┌─────────────────┐
│   MCP Client    │  (Claude Desktop, Cursor, etc.)
│  (Natural Lang) │
└────────┬────────┘
         │ MCP Protocol
┌────────▼────────┐
│   MCP Server    │  (Python)
│   + Gemini AI   │  - Network generation
│                 │  - Code generation
└────────┬────────┘
         │ Socket.IO (port 7531)
┌────────▼────────┐
│ PT Extension    │  (JavaScript)
│  cisco-pt-mcp   │  - PTBuilder integration
│                 │  - Web interface
└────────┬────────┘
         │ IPC API
┌────────▼────────┐
│ Packet Tracer   │  (Cisco Application)
│   Workspace     │
└─────────────────┘

🤝 Mitwirken

Beiträge willkommen! Dieses Projekt integriert:

• Model Context Protocol (MCP)

• PTBuilder – JavaScript-Automatisierung für PT

• Gemini API – KI-Netzwerkgenerierung

📄 Lizenz

MIT-Lizenz – Siehe LICENSE-Datei

🙏 Danksagungen

• PTBuilderator von kimmknight – JavaScript-Automatisierungs-Schnapp

• MCP-Protokoll – Standard für die Kommunikation zwischen KI-Anwendungen

• Google Gemini – Fähigkeiten zur KI-Generierung

• Original cisco-pt-mcp von muhammadbalawal

🆘 Support & Probleme

• Fehlerbehandlung: Siehe SETUP_GUIDE.md

• Probleme: Erstellen Sie ein Issue auf GitHub

• Dokumentation: Schauen Sie in den docs-Ordner

Geben Sie diesem Repo einen ⭐ Stern, wenn Sie es nützlich finden!