🚀 Integrasi MikroTik MCP dengan Gemini AI
📋 Daftar Isi
- Overview
- Prerequisites
- Struktur File
- Instalasi Cepat
- Penggunaan
- Deployment
- Contoh Penggunaan
- Troubleshooting
🔍 Overview
Integrasi ini memungkinkan Anda bertanya tentang perangkat MikroTik menggunakan Google Gemini AI dengan konteks data real-time dari perangkat.
Fitur Utama:
- ✅ Query natural language tentang MikroTik
- ✅ Context-aware responses
- ✅ Real-time monitoring
- ✅ Web API interface
- ✅ Docker deployment
- ✅ Optimized token usage
📦 Prerequisites
1. Google Cloud Account
- API Key Gemini dari Google AI Studio
2. Python 3.11+
python --version
3. MikroTik Data
File: mikrotik_mcp_data.json (sudah ada di project)
📁 Struktur File
gemini_integration/
├── README.md # File ini
├── gemini_mikrotik_integration.py # Script utama
├── api_server.py # FastAPI server
├── realtime_monitor.py # Monitoring real-time
├── context_optimizer.py # Optimasi context
├── update_data.py # Script update data MikroTik
├── requirements.txt # Dependencies
├── docker-compose.yml # Docker deployment
├── config.yaml # Konfigurasi
├── example_prompts.md # Contoh prompt
├── .env.example # Template environment
└── logs/ # Log directory (auto-created)
## ⚡ **Instalasi Cepat**
### **Step 1: Setup Environment**
```bash
cd /a0/usr/projects/project_1/gemini_integration
# Copy environment template
cp .env.example .env
# Edit .env dengan API key Anda
nano .env
Step 2: Install Dependencies
pip install -r requirements.txt
Step 3: Test Integration
python gemini_mikrotik_integration.py
🎯 Penggunaan
1. Interactive Chat
python gemini_mikrotik_integration.py
2. Web API
python api_server.py
# Akses: http://localhost:8000/docs
3. Real-time Monitoring
python realtime_monitor.py
🐳 Deployment dengan Docker
Build dan Run
docker-compose up -d
Check Status
docker-compose ps
curl http://localhost:8000/health
💡 Contoh Penggunaan
Via Python Script
from gemini_mikrotik_integration import MikroTikGeminiAssistant
assistant = MikroTikGeminiAssistant()
answer = assistant.ask_question("Berapa CPU usage router?")
print(answer)
Via API
curl -X POST http://localhost:8000/ask \
-H "Content-Type: application/json" \
-d '{"question": "Ada berapa interface yang running?"}'
🔧 Troubleshooting
Error: API Key Invalid
# Periksa .env file
cat .env | grep GEMINI_API_KEY
Error: MikroTik Data Not Found
# Pastikan file data ada
ls -la ../mikrotik_mcp_data.json
Error: Port Already in Use
# Ganti port di api_server.py atau kill process
lsof -i :8000
kill -9 <PID>
📞 Support
- Issues: Check error logs
- Questions: Lihat example_prompts.md
- Updates: Pantau perubahan API Gemini
📄 License
MIT License - Bebas digunakan untuk keperluan apapun.
Dibuat oleh: Agent Zero AI Assistant Tanggal: 2026-01-20 Versi: 1.0.0
Description
Languages
Python
100%