Cisco Packet Tracer MCP Server

Otomatisasi Perancangan, Konfigurasi, dan Diagnostik Jaringan Cisco Packet Tracer Menggunakan AI

Jelaskan kebutuhan jaringan Anda dalam bahasa sehari-hari. AI akan merancang topologi, memvalidasi aturan teknis, menyusun konfigurasi IOS CLI, membangun topologi secara langsung (live deploy) di Cisco Packet Tracer, hingga memverifikasi koneksi dengan pengujian ping dan capture paket.

Baru di v0.12.0 — PKA Builder: Buat ujian dan tugas lab Cisco Packet Tracer (.pka) otomatis dengan satu instruksi, lengkap dengan penilaian skor otomatis (auto-grading).

Instalasi otomatis melalui asisten AI: "Install the Packet Tracer MCP from https://github.com/namakaze65-code/MCP-Packet-Tracer.git and set everything up for me."

Demonstrasi Sistem

Related MCP server: Packet Tracer MCP Server

PKA Builder: Pembuat Soal & Ujian CCNA Otomatis

Mulai dari versi v0.12.0, MCP Packet Tracer dilengkapi dengan PKA Builder:

• Pembuatan Soal Ujian Otomatis: Buat berkas .pka (Packet Tracer Activity) lengkap dengan petunjuk instruksi HTML, topologi awal (initial network), dan kunci jawaban (answer network).

• Auto-Grading Real-Time: Siswa/mahasiswa langsung mendapatkan skor persentase secara otomatis saat menyelesaikan langkah konfigurasi di Packet Tracer.

• Tools pt_activity_*: Membuka, menguji, dan membangun tugas berbasis Activity Wizard di Windows dan macOS.

Arsitektur dan Cara Kerja Sistem

Sistem ini menghubungkan Model Context Protocol (MCP) dari AI Coding Agent (seperti Claude Code, Cursor, Antigravity, OpenCode, atau Codex) ke Cisco Packet Tracer melalui jembatan komunikasi lokal yang aman:

flowchart TD
    User["Pengguna / Teknisi Jaringan<br/>'Buat topologi 3 Router OSPF dengan DHCP dan 6 PC'"] --> Agent["AI Coding Agent<br/>(Claude Code, Antigravity, Cursor, Codex)"]
    
    subgraph MCP_Layer ["Packet Tracer MCP Server (Python)"]
        Agent --> Tools["111 pt_* Tools<br/>(Planning, Validation, CLI, Activity, Inspection)"]
        Tools --> Core["Planner & Rules Engine<br/>- Alokasi IP / Subnetting<br/>- Validasi Topologi & Kabel<br/>- Generator Skrip JS & Config IOS<br/>- PKA Activity Engine"]
    end
    
    subgraph Bridge_Layer ["Jembatan Komunikasi Lokal"]
        Core --> HTTP["Local HTTP Bridge<br/>(127.0.0.1:54321 + Token Otentikasi)"]
        Core --> FileMB["Fallback File Mailbox<br/>(Bekerja saat jendela ekstensi tertutup)"]
    end
    
    subgraph PT_Layer ["Lingkungan Cisco Packet Tracer"]
        HTTP --> Ext["MCP Control Center (.pts)<br/>Ekstensi Script Engine Packet Tracer"]
        FileMB --> Ext
        Ext --> Canvas["Kanvas & Simulasi Perangkat<br/>- Penempatan perangkat otomatis<br/>- Pemasangan kabel presisi<br/>- Injeksi konfigurasi CLI IOS<br/>- Simulasi paket PDU / Ping<br/>- Activity Wizard Grading"]
    end

    Canvas --> Feedback["Umpan Balik Hasil Diagnostik<br/>Hasil Ping, Tabel Rute, Wireshark Trace, Status Port, Skor .pka"]
    Feedback --> Agent

Ringkasan Fitur dan Kapabilitas

Panduan Instalasi Cepat

Metode 1: Otomatis via Coding Agent (Direkomendasikan)

Cukup berikan instruksi ini pada asisten AI Anda (Antigravity / Claude Code / Cursor / Codex):

Install the Packet Tracer MCP from https://github.com/namakaze65-code/MCP-Packet-Tracer.git and set everything up for me.

AI akan mendeteksi sistem operasi Anda, mengunduh repositori, menginstal server MCP dan dependensi Python, serta menempatkan ekstensi Packet Tracer di folder yang tepat.

Metode 2: Instalasi Manual

1. Pasang Manajer Paket uv

uv menyediakan runtime Python independen tanpa mengganggu instalasi sistem:

• Windows (PowerShell):

  powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

• macOS / Linux:

  curl -LsSf https://astral.sh/uv/install.sh | sh

2. Kloning Repositori

git clone https://github.com/namakaze65-code/MCP-Packet-Tracer.git
cd MCP-Packet-Tracer

3. Pasang Server MCP

uv tool install . --force

4. Daftarkan Server MCP ke Client Anda

• Untuk Claude Code:

  claude mcp add --scope user --transport stdio packet-tracer "--" uvx --from . packet-tracer-mcp --stdio

• Untuk Antigravity / Cursor / VSCode (mcp_config.json):

  {
    "mcpServers": {
      "packet-tracer": {
        "command": "packet-tracer-mcp",
        "args": ["--stdio"]
      }
    }
  }

5. Pasang Ekstensi Packet Tracer (MCP-Control-Center.pts)

Salin file MCP-Control-Center.pts ke folder ekstensi Cisco Packet Tracer Anda:

• Windows: C:\Program Files\Cisco Packet Tracer <versi>\extensions\MCPControlCenter\

• macOS: /Applications/Cisco Packet Tracer <versi>.app/Contents/extensions/MCPControlCenter/

Saat Packet Tracer dibuka kembali dan muncul dialog: "Detected a new script module... enable?", klik Yes.

Contoh Penggunaan Praktis

Berikut adalah contoh instruksi dalam Bahasa Indonesia yang dapat Anda berikan langsung ke AI:

1. Jaringan Multi-Router dengan Dynamic Routing OSPF

"Buat topologi 3 Router Cisco 2911 membentuk segitiga redundansi. Hubungkan tiap router dengan kabel serial/gigabit subnet /30. Pasang 1 Switch dan 2 PC di belakang masing-masing router. Aktifkan OSPF area 0 pada semua router dan buat DHCP pool di setiap LAN. Setelah selesai, lakukan tes ping antar PC untuk membuktikan konektivitas dan buatkan laporan rapi format docx."

2. Inter-VLAN Routing (Router-on-a-Stick) dan Extended ACL

"Buat topologi Router-on-a-Stick menggunakan 1 Router 2911 dan 1 Switch 2960. Buat VLAN 10 untuk Keuangan dan VLAN 20 untuk Server Web. Aktifkan trunk 802.1Q dan buat sub-interface G0/0.10 serta G0/0.20. Terapkan Extended ACL di router untuk memblokir akses HTTP dari VLAN 10 ke Server Web di VLAN 20, lalu verifikasi dengan capture paket Wireshark di Packet Tracer dan buatkan laporan pengujiannya."

3. Analisis Failover Jalur Redundansi

"Simulasikan jalur Jakarta ke Surabaya melalui jalur utama Router 2 dan jalur cadangan Router 4. Jalankan perintah tracert dari PC Jakarta ke PC Surabaya. Kemudian putuskan interface jalur utama (shutdown), jalankan tracert kembali, dan jelaskan mengapa rute otomatis beralih ke jalur cadangan dalam laporan teknis."

Struktur Direktori Repositori

MCP-Packet-Tracer/
├── .agents/                        # Konfigurasi skill & aturan agen otomatis
│   ├── rules/auto_report.md        # Aturan wajib pelaporan rapi dan monokrom
│   └── skills/                     # Skill pelaporan formal bawaan workspace
├── demo/                           # Aset visual, banner, screenshot, dan gif demo
├── docs/                           # Dokumentasi teknis lengkap dan panduan tool
├── EXTENSION/                      # Source code ekstensi JavaScript Packet Tracer
│   ├── script-engine/main.js       # Runtime pengontrol API internal Packet Tracer
│   └── webview/                    # Tampilan antarmuka HTML/JS Control Center
├── skills/                         # Skill resmi formal-report-generator
│   └── formal-report-generator/    # Skrip pembantu dokumen Word & template
│       ├── scripts/report_helper.py# Pustaka pembantu layout Word & PIL
│       ├── templates/              # Template dokumen Word baku
│       └── SKILL.md                # Spesifikasi dan panduan skill laporan
├── src/packet_tracer_mcp/          # Inti server Python Model Context Protocol
│   ├── adapters/mcp/tools/         # Implementasi 111 tools pt_* (ACL, OSPF, VLAN, Activity, dll.)
│   ├── domain/                     # Logika perencanaan topologi, aturan validasi & exam rules
│   └── infrastructure/             # Jembatan HTTP loopback, Activity Wizard UI & eksekutor
├── tests/                          # 1.697 pengujian unit test dan regresi offline
├── AGENTS.md                       # Panduan teknis perilaku agen coding AI
├── MCP-Control-Center.pts          # Ekstensi siap pakai untuk Cisco Packet Tracer
├── pyproject.toml                  # Konfigurasi dependensi project Python (v0.12.0)
└── README.md                       # Dokumentasi utama proyek

Aspek Keamanan Sistem

• Loopback Only: Server jembatan komunikasi hanya terhubung ke alamat lokal 127.0.0.1 dan menolak seluruh koneksi jaringan luar.

• Token Otentikasi Acak: Setiap sesi dilindungi dengan token acak yang disimpan di direktori terproteksi %LOCALAPPDATA% pengguna.

• DNS-Rebinding Defense: Header Host diverifikasi terhadap 127.0.0.1 / localhost dan port riil.

• Tanpa f-string JavaScript Mentah: Seluruh parameter perintah diproses melalui enkapsulasi JSON yang ketat untuk mencegah injeksi kode pada Script Engine Cisco Packet Tracer.

Panduan Kontribusi

Kontribusi perbaikan kode, penambahan fitur perangkat, atau dokumentasi:

1. Fork repositori ini: https://github.com/namakaze65-code/MCP-Packet-Tracer.git

2. Buat branch fitur baru (git checkout -b feature/FiturBaru)

3. Jalankan pengujian: python -m pytest

4. Commit perubahan Anda (git commit -m "feat: Menambahkan fitur X")

5. Push ke branch Anda (git push origin feature/FiturBaru)

6. Buat Pull Request baru.

Lisensi

Proyek ini dilisensikan di bawah lisensi terbuka MIT License — © 2026 Mateo (@Mats2208). Anda bebas menggunakannya untuk keperluan riset, tugas kuliah, praktikum laboratorium, maupun pengembangan otomasi jaringan korporat.