Enables network automation for Cisco devices via SSH using Netmiko, providing tools to retrieve interface information, device status, running/startup configurations, resource usage (CPU/memory), and uptime from Cisco routers and switches.
Netmiko MCP Server
MCP (Model Context Protocol) Server untuk automasi jaringan Cisco menggunakan Netmiko. Server ini mengekspos tools untuk berinteraksi dengan perangkat Cisco melalui SSH, dan dapat diakses oleh LLM clients seperti Claude Desktop.
Yang baru dibuat
Get Interfaces: Ambil daftar semua interface dan statusnya
Get Device Status: Ambil informasi device (version, uptime, dll)
Get Running Config: Ambil konfigurasi yang sedang berjalan
Interface Details: Ambil detail spesifik untuk interface tertentu
Resource Monitoring: Monitor CPU dan memory usage
sambungin ke claude desktop: Komunikasi dengan router menggunakan bahasa natural melalui Claude Desktop
harus punya....
Python 3.8 atau lebih baru
Akses ke Cisco DevNet Sandbox (gratis) atau perangkat Cisco lainnya
Koneksi internet untuk DevNet Sandbox
Claude Desktop (untuk LLM integration)
instalasi
1. navigasi ke folder projek
2. Buat virtual environment (optional)
3. install requriements
Konfigurasi utama untuk device
Menggunakan Cisco DevNet Sandbox - Catalyst 8000 Always-On
File config.py perlu dikonfigurasi dengan kredensial dari DevNet Sandbox:
Login ke DevNet Sandbox: https://devnetsandbox.cisco.com/
Pilih "Catalyst 8000 Always-On Sandbox"
Launch sandbox untuk mendapatkan kredensial unik
Copy kredensial dari Quick Access Tab
Update :
Penting:
Setiap user mendapat kredensial unik
Password case-sensitive (perhatikan angka 0 vs huruf O)
Sandbox ini VPN-less (tidak perlu VPN)
Menggunakan Device Sendiri
Edit config.py dan ganti dengan kredensial device fisiknya nanti:
Cara Pake
Testing Individual Tools
Setiap tool bisa ditest secara sendiri/individu:
Menjalankan MCP Server
Server akan berjalan dan menunggu koneksi dari MCP client (seperti Claude Desktop).
Tools yang Tersedia
1. get_interfaces
Mendapatkan daftar semua interface dari device.
2. get_interface_detail
Mendapatkan detail spesifik untuk satu interface.
Parameters:
interface_name(required): Nama interface (contoh: "GigabitEthernet1")
Output: show interface <name>
3. get_device_status
Mendapatkan informasi umum device (version, model, uptime).
Output: show version dan hostname
4. get_device_uptime
Mendapatkan informasi uptime device.
Output: Uptime dari show version
5. get_resource_usage
Mendapatkan informasi CPU dan memory usage.
Output: CPU dan memory statistics
6. get_running_config
Mendapatkan running configuration.
Parameters:
filter_keyword(optional): Filter konfigurasi (contoh: "interface", "ip")
Output: show running-config (filtered atau full)
7. get_interface_config
Mendapatkan konfigurasi untuk interface spesifik.
Parameters:
interface_name(required): Nama interface
Output: show running-config interface <name>
8. get_startup_config
Mendapatkan startup configuration (saved config).
Output: show startup-config
Testing
Test Koneksi ke DevNet Sandbox
Jalankan script test yang sudah disediakan:
Hasil Testing (progress day week 1)
Test 1: Connection Test
command: python test_connection.py
untuk test koneksi dasar ke cisco device, verifikasi kredensial, dan informasi umum seperti version, hostname, dan interfaces.
output:
Test 2: Get Interfaces
command: python tools/get_interfaces.py
deskripsi: Test tool untuk mendapatkan daftar semua interface dan statusnya (output dari show ip interface brief).
Test 3: Get Device Status
command: python tools/get_device_status.py
deskripsi: Test tool untuk mendapatkan informasi device (IOS version, hostname, uptime, CPU/memory).
Test 4: Get Running Config
command: python tools/get_running_config.py
deskripsi:Test tool untuk mendapatkan running configuration. Script ini akan menjalankan 2 test:
Test 1: Filtered config dengan keyword "interface" Test 2: Config untuk specific interface (GigabitEthernet1)
Test 4a: Filtered Config (interface)
command: python test_connection.py
Test 5: MCP Server
Command: python mcp_server.py
deskripsi: Menjalankan MCP server yang akan menunggu koneksi dari Claude Desktop.
Setting buat Claude Desktop
1. Lokasi File Konfigurasi Claude Desktop
Windows:
Linux:
2. Edit Konfigurasi
Tambahkan MCP server Anda ke dalam file konfigurasi:
3. Restart Claude Desktop
4. Verifikasi
Di Claude Desktop, coba perintah seperti:
atau
Claude akan menggunakan tools MCP untuk mengeksekusi perintah di router.
