🛜 Tum's MikroTik MCP Server

MCP (Model Context Protocol) Server สำหรับจัดการ MikroTik RouterOS ผ่าน SSH

✨ Features

MCP Server นี้มี Tools ทั้งหมด 12 ตัว สำหรับจัดการ MikroTik:

📊 Network Information

• mikrotik_get_ip_addresses - ดูรายการ IP Address ทั้งหมด
• mikrotik_get_interface_status - เช็คสถานะ Interface
• mikrotik_get_dhcp_leases - ดู DHCP Leases
• mikrotik_get_routes - ดู Routing Table
• mikrotik_get_bridges - ดู Bridge Interfaces
• mikrotik_get_wireless_interfaces - ดู Wireless Interfaces

🔒 Security & Firewall

• mikrotik_get_firewall_rules - ดู Firewall Filter Rules
• mikrotik_get_nat_rules - ดู NAT Rules

⚙️ System

• mikrotik_get_system_resources - ดู CPU, Memory, Uptime
• mikrotik_get_dns_settings - ดู DNS Settings
• mikrotik_test_connection - ทดสอบการเชื่อมต่อ

🛠️ Advanced

• mikrotik_execute_command - รันคำสั่ง RouterOS แบบ Custom (Read-only)

📋 Prerequisites

• Node.js 18+
• MikroTik Router with SSH enabled
• SSH credentials (username/password)

🚀 Installation

Local Development

# Clone or navigate to the project
cd /home/rookief/MCP/mikrotik

# Install dependencies
npm install

# Build
npm run build

Configuration

สร้างไฟล์ ~/.env/mikrotik.env:

MIKROTIK_HOST="IP GATEWAY"
MIKROTIK_USERNAME="your-username"
MIKROTIK_PASSWORD="your-password"
MIKROTIK_PORT="22"

Add to Opencode

เพิ่มใน ~/.config/opencode/opencode.json:

{
  "mcpServers": {
    "mikrotik": {
      "command": "node",
      "args": ["/home/rookief/MCP/mikrotik/dist/index.js"]
    }
  }
}

หรือใช้ shell wrapper เพื่อความปลอดภัย:

{
  "mcpServers": {
    "mikrotik": {
      "command": "bash",
      "args": [
        "-c",
        "source ~/.env/mikrotik.env && node /home/rookief/MCP/mikrotik/dist/index.js"
      ]
    }
  }
}

🎯 Usage Examples

ตัวอย่างการใช้งาน

// ดู IP Addresses
mikrotik_get_ip_addresses()

// เช็คสถานะ Interface
mikrotik_get_interface_status()

// ดู System Resources
mikrotik_get_system_resources()

// รันคำสั่งแบบกำหนดเอง
mikrotik_execute_command({
  command: "/system identity print"
})

🔒 Security

• Tools ทั้งหมดเป็น Read-only เป็นหลัก
• mikrotik_execute_command มีการป้องกันคำสั่งอันตราย:
  • ไม่อนุญาต: /system reset, /system reboot, remove
  • แนะนำให้ใช้กับคำสั่ง print เท่านั้น

🧪 Development

# Run in development mode (with auto-reload)
npm run dev

# Build for production
npm run build

# Test connection
npm run start

📁 Project Structure

mikrotik/
├── src/
│   ├── index.ts          # MCP Server main
│   └── mikrotik.ts       # SSH Client & RouterOS commands
├── dist/                 # Compiled JavaScript
├── package.json
├── tsconfig.json
└── README.md

🐛 Troubleshooting

Connection Failed

1. เช็ค SSH credentials ใน ~/.env/mikrotik.env
2. ทดสอบการเชื่อมต่อ: ssh [email protected]
3. ตรวจสอบว่า SSH service เปิดอยู่บน MikroTik

Tools ไม่แสดง

1. Restart Opencode
2. เช็ค logs: tail -f ~/.config/opencode/mcp-*.log
3. ทดสอบรัน server: npm run start

📝 License

MIT

👤 Author

Tum

Made with ❤️ for MikroTik RouterOS automation