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
cd netmiko_mcp_server
2. Buat virtual environment (optional)
# Windows
python -m venv venv
venv\Scripts\activate
# Linux/Mac
python3 -m venv venv
source venv/bin/activate
3. install requriements
pip install -r requirements.txt
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
config.py:
DEVNET_DEVICE = {
"device_type": "cisco_ios",
"host": "devnetsandboxiosxec8k.cisco.com",
"port": 22,
"username": "your_username", # Dari DevNet Sandbox
"password": "your_password", # Dari DevNet Sandbox
"secret": "your_password",
"timeout": 30,
}
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:
DEVNET_DEVICE = {
"device_type": "cisco_ios", # atau cisco_xe, cisco_xr, dll
"host": "192.168.1.1", # IP router/switch Anda
"port": 22,
"username": "admin",
"password": "your_password",
"secret": "your_enable_password",
"timeout": 30,
}
Cara Pake
Testing Individual Tools
Setiap tool bisa ditest secara sendiri/individu:
# Test get interfaces
python tools/get_interfaces.py
# Test device status
python tools/get_device_status.py
# Test running config
python tools/get_running_config.py
Menjalankan MCP Server
python mcp_server.py
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:
python test_connection.py
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:
%APPDATA%\Claude\claude_desktop_config.json
Linux:
~/.config/Claude/claude_desktop_config.json
2. Edit Konfigurasi
Tambahkan MCP server Anda ke dalam file konfigurasi:
{
"mcpServers": {
"netmiko-cisco": {
"command": "python",
"args": [
"C:\\Life\\kuliah\\RISET_ASET\\netmiko_mcp_server\\mcp_server.py"
],
"env": {}
}
}
}
3. Restart Claude Desktop
4. Verifikasi
Di Claude Desktop, coba perintah seperti:
Get the list of interfaces from the Cisco router
atau
What is the hostname and version of the Cisco device?
Claude akan menggunakan tools MCP untuk mengeksekusi perintah di router.
