路由器管理AI助手

MCP Server Mikrotik RouterOS 7

MCP Server untuk manajemen router Mikrotik RouterOS 7 melalui AI Assistant. Menyediakan 72 tools untuk monitoring dan konfigurasi router menggunakan REST API.

Tentang Repository

Project ini adalah implementasi Model Context Protocol (MCP) server yang memungkinkan AI assistant (seperti Claude Desktop atau VS Code Copilot) untuk berinteraksi dengan router Mikrotik RouterOS 7. Dengan tools ini, Anda bisa melakukan monitoring, konfigurasi firewall, routing, VPN, DHCP, DNS, dan berbagai fitur router lainnya menggunakan bahasa natural.

Fitur utama:

• 72 tools untuk manajemen lengkap: Monitoring, Firewall, Routing, VPN, DHCP, DNS, Queue, dan lainnya
• REST API based - aman dan modern
• Rate limiting untuk melindungi router
• Support SSL/TLS
• Async operations untuk performa optimal

Konfigurasi

1. Persiapan Router

Aktifkan REST API di router Mikrotik:

/ip service enable api-ssl
/ip service set api-ssl port=443

2. Install Package

pip install -e .

3. Konfigurasi Environment

Buat file .env di root folder project:

MIKROTIK_HOST=192.168.88.1
MIKROTIK_PORT=443
MIKROTIK_USERNAME=admin
MIKROTIK_PASSWORD=your_password
MIKROTIK_USE_SSL=true
MIKROTIK_VERIFY_SSL=false

Catatan keamanan: Gunakan MIKROTIK_VERIFY_SSL=true untuk production dengan certificate yang valid.

Cara Pakai

Testing

Jalankan server secara manual untuk testing:

python -m mcp_mikrotik

Server akan berjalan dan menampilkan available tools. Tekan Ctrl+C untuk stop.

Contoh Perintah

Setelah terhubung dengan AI assistant, Anda bisa menggunakan perintah natural seperti:

• "Tampilkan status CPU dan memory router"
• "Lihat daftar lease DHCP yang aktif"
• "Tambahkan rule firewall untuk block IP 192.168.1.100"
• "Buat static route ke network 10.0.0.0/24 via gateway 192.168.88.254"
• "Lihat interface yang up"

Cara Pakai di VS Code

1. Install MCP Extension

Install extension yang support MCP di VS Code. Contoh:

• Cline (recommended)
• Continue
• Roo Cline

2. Konfigurasi MCP Settings

Untuk VS Code dengan extension Cline, buka Command Palette (Ctrl+Shift+P) dan pilih "Cline: Open MCP Settings", lalu tambahkan:

{
  "mcpServers": {
    "mikrotik": {
      "command": "python",
      "args": ["-m", "mcp_mikrotik"],
      "env": {
        "MIKROTIK_HOST": "192.168.88.1",
        "MIKROTIK_USERNAME": "admin",
        "MIKROTIK_PASSWORD": "your_password",
        "MIKROTIK_PORT": "443",
        "MIKROTIK_USE_SSL": "true",
        "MIKROTIK_VERIFY_SSL": "false"
      }
    }
  }
}

Atau bisa juga gunakan file .env yang sudah dikonfigurasi sebelumnya tanpa perlu set env di config.

3. Mulai Pakai

Setelah extension terinstall dan MCP server terkonfigurasi, mulai chat dengan AI assistant di VS Code dan gunakan perintah natural:

• "Tampilkan resource router"
• "Lihat semua firewall rules"
• "Buat user baru dengan nama operator1"
• "Siapa yang sedang connect via VPN?"

Troubleshooting

Tidak bisa connect ke router:

• Pastikan REST API sudah enabled di router
• Cek firewall tidak block port 443
• Test koneksi: curl -k -u admin:password https://192.168.88.1/rest/system/resource

MCP server tidak terdeteksi di VS Code:

• Restart VS Code setelah konfigurasi
• Cek syntax JSON di MCP settings
• Pastikan Python dan package sudah terinstall

License

MIT License

Python 3.10+ | 72 Tools | MCP Protocol