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.

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

Demonstrasi Sistem

Related MCP server: Packet Tracer MCP Server

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["98 pt_* Tools<br/>(Planning, Validation, CLI, Inspection)"]
        Tools --> Core["Planner & Rules Engine<br/>- Alokasi IP / Subnetting<br/>- Validasi Topologi & Kabel<br/>- Generator Skrip JS & Config IOS"]
    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"]
    end

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

Ringkasan Fitur dan Kapabilitas

Skill Otomasi Pelaporan Formal (formal-report-generator)

Repositori ini telah dibekali dengan modul skill terintegrasi bernama formal-report-generator yang berlokasi di folder skills/formal-report-generator/ dan .agents/skills/formal-report-generator/. Skill ini mewajibkan agen AI untuk secara mandiri menyusun dokumen laporan laboratorium atau dokumen teknis standar industri dalam format ganda (.docx dan .doc) setiap kali sebuah simulasi atau troubleshooting selesai dijalankan.

flowchart LR
    A["Simulasi Jaringan Selesai"] --> B["Pengambilan Bukti Diagnostik<br/>(1 Gambar Topologi, CLI, Tracert, Wireshark)"]
    B --> C["Penyusunan Laporan Standar<br/>- 100% Times New Roman<br/>- Format Monokrom (#000000)<br/>- Flowchart Tanpa Tumpang Tindih"]
    C --> D["Penyimpanan File Laporan<br/>Laporan_Praktikum.docx<br/>Laporan_Praktikum.doc"]

Standar Baku Pelaporan (Non-Negotiable Rules):

1. Tipografi 100% Times New Roman:

   • Seluruh elemen teks tanpa kecuali menggunakan font Times New Roman:

     • Judul Utama: 14 pt, Tebal, Rata Tengah

     • Judul Bab (H1): 13 pt, Tebal, Rata Kiri

     • Sub-bab (H2): 12 pt, Tebal, Rata Kiri

     • Isi Paragraf: 12 pt, Normal, Rata Kanan-Kiri (Justified), Spasi 1.15

     • Isi Tabel: 9.5 pt hingga 10.5 pt

     • Keterangan Gambar / Tabel: 10 pt, Miring (Italic), Rata Tengah

   • Dilarang keras menggunakan font default seperti Calibri, Arial, atau font monospace pada teks paragraf.

2. Disiplin Warna Monokrom (Tanpa Warna-Warni):

   • Seluruh teks paragraf dan heading wajib menggunakan warna hitam pekat (#000000).

   • Tabel: Baris judul (header) menggunakan latar abu-abu terang netral (#F2F2F2) dengan teks hitam tebal dan garis batas tipis solid (#000000 atau #CCCCCC).

   • Kotak Catatan (Callout Box): Latar abu-abu terang (#F5F5F5) dengan garis batas tebal hitam di sisi kiri.

   • Tidak diperkenankan menggunakan teks berwarna biru, merah, hijau, atau latar warna mencolok di dalam laporan.

3. Aturan 1 Gambar Topologi di Awal Dokumen:

   • Gambar diagram topologi Packet Tracer hanya disertakan tepat satu kali di awal laporan (Bab I).

   • Dilarang mengulang gambar topologi di bab-bab selanjutnya; bab pengujian hanya menampilkan screenshot bukti CLI, output ping, tracert, atau capture paket.

   • Penataan pada kanvas Packet Tracer wajib menyertakan label subnet pada kabel jaringan dan IP lengkap tepat di bawah nama tiap PC atau Server.

4. Diagram Alur (Flowchart) Tanpa Tumpang Tindih (Zero-Overlap):

   • Diagram diagnostik dirancang dengan jarak aman minimal 40 px antar-cabang paralel.

   • Setiap percabangan keputusan (decision diamond) memiliki kolom koordinat tersendiri agar teks tidak terpotong atau tertutup garis.

   • Menggunakan jalur garis siku (orthogonal lines) dengan panah presisi, font Times New Roman, dan palet monokrom hitam-putih.

5. Ekspor Ganda Otomatis (.docx dan .doc):

   • Agen secara otomatis menghasilkan sepasang berkas: .docx (format Word modern) dan .doc (format kompatibilitas lama) langsung di direktori proyek dan menyertakan tautan file yang dapat diklik langsung oleh pengguna.

Berkas dan Komponen Skill:

• Spesifikasi & Panduan Skill: skills/formal-report-generator/SKILL.md

• Pustaka Skrip Pembantu Python: skills/formal-report-generator/scripts/report_helper.py (menyediakan fungsi set_cell_background, set_table_borders, add_callout, render_cmd_window, dan render_flowchart).

• Template Dokumen Baku: skills/formal-report-generator/templates/report_template.py

• Aturan Permanen Agen: .agents/rules/auto_report.md dan bab khusus di AGENTS.md.

Panduan Instalasi

Prasyarat Sistem:

• Cisco Packet Tracer: Versi 8.2, 8.2.2, 9.0, atau 9.0.1 (Windows, macOS, atau Linux).

• Python: Versi 3.11+ atau manajer paket cepat uv.

Metode 1: Instalasi Otomatis Menggunakan Coding Agent (Direkomendasikan)

Buka terminal AI Coding Agent Anda (Claude Code, Antigravity, Cursor, Codex, dll.) lalu jalankan perintah berikut:

Install the Packet Tracer MCP from https://github.com/Masmas99/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/Masmas99/MCP-Packet-Tracer.git
cd MCP-Packet-Tracer

3. Daftarkan Server MCP ke Client Anda

• Untuk Claude Code (Windows PowerShell):

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

• Untuk Claude Code (macOS / Linux):

  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": "uvx",
        "args": ["--from", "C:/laragon/www/mcp-to-cisco", "packet-tracer-mcp", "--stdio"]
      }
    }
  }

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

1. Salin file MCP-Control-Center.pts yang ada di repositori ini.

2. Buka folder ekstensi Packet Tracer:

   • Windows: C:\Program Files\Cisco Packet Tracer <versi>\extensions\MCPControlCenter\ (atau di %USERPROFILE%\Cisco Packet Tracer <versi>\extensions\MCPControlCenter\).

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

   • Linux: Buka menu Extensions -> Scripting -> Configure PT Script Modules -> Add... lalu pilih file MCP-Control-Center.pts.

3. 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 98 tools pt_* (ACL, OSPF, VLAN, dll.)
│   ├── domain/                     # Logika perencanaan topologi & aturan validasi
│   └── infrastructure/             # Jembatan HTTP loopback & eksekutor perintah
├── tests/                          # Rangkaian pengujian unit test dan regresi
├── 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
└── 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.

• 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/Masmas99/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. Anda bebas menggunakannya untuk keperluan riset, tugas kuliah, praktikum laboratorium, maupun pengembangan otomasi jaringan korporat.