LightBill MCP Server

mcp-name: io.github.lightnet19/lightbill-mcp-server

MCP (Model Context Protocol) server untuk mengelola LightBill — ISP billing & client management platform — melalui AI agents (Hermes/ARKA, Claude, n8n, dll).

Membungkus 124+ API routes LightBill menjadi 134 tools dengan autentikasi AI API key (X-AI-Key) — tanpa flow login JWT manual.

✨ Fitur

• 👥 Pelanggan — CRUD penuh + isolir/reaktivasi + sesi PPPoE + pemakaian
• 👷 Karyawan — CRUD (owner/admin/noc/kasir/teknisi/reseller)
• 🔧 Router MikroTik — CRUD + sinkronisasi + monitoring (traffic, resource, syslog, ip-pools, ping, top-consumers, active sessions)
• ⚡ OLT & ONT — CRUD + ONT (create/delete/reboot/history) + ZTP + discovery + health
• 💵 Tagihan & Pembayaran — konfirmasi lunas (auto-reaktivasi), generate, verifikasi bukti transfer approve/reject
• 📦 Paket & Template — CRUD paket layanan + template pesan WhatsApp
• 💸 Keuangan — pengeluaran CRUD, laporan daily/monthly/yearly
• 🎫 Hotspot, Mitra, ODC/ODP — batch voucher, deposit reseller, topologi jaringan
• 🎟️ Helpdesk & Chat — tiket (CLAIM/ASSIGN/RESOLVE/CLOSE), live chat
• 📋 Job & Backup — tugas lapangan, export/restore data
• 📊 Analitik & Payroll — churn prediction, forecasting, generate gaji
• 📦 Inventaris — perangkat, bahan habis pakai, movement (borrow/return/install)
• 📡 Radius & Isolir — kick sesi, enforce/reset FUP, lookup
• ⚙️ Pengaturan — payment gateway (Tripay/Duitku/Midtrans/Xendit), profil tenant

🚀 Instalasi

Prasyarat

• LightBill berjalan dengan AI_API_KEY di .env (lihat API-AI-AGENT.md)
• Python 3.10+

Setup

git clone https://github.com/lightnet19/lightbill-mcp-server.git
cd lightbill-mcp-server
python3 -m venv venv
venv/bin/pip install fastmcp httpx
cp run.sh.example run.sh   # lalu isi LIGHTBILL_API_KEY
chmod +x run.sh

Registrasi ke Hermes

hermes mcp add lightbill --command "$(pwd)/run.sh"
# → 134/134 tools enabled

Registrasi ke client MCP lain (Claude Desktop, dll)

{
  "mcpServers": {
    "lightbill": {
      "command": "/path/to/lightbill-mcp-server/run.sh"
    }
  }
}

🔑 Autentikasi

Server membaca LIGHTBILL_API_KEY dari environment (via run.sh). Key dikirim sebagai header X-AI-Key ke setiap request API LightBill.

# run.sh
export LIGHTBILL_BASE_URL="https://your-lightbill-domain.com"
export LIGHTBILL_API_KEY="your-ai-api-key"

🛠️ Daftar Tools (134)

⚠️ Catatan Keamanan

• Aksi destruktif (delete) & berdampak layanan (reboot ONT, kick radius, restore backup) — konfirmasi manusia disarankan.
• Password router/OLT dienkripsi di database LightBill.
• Jangan commit AI_API_KEY ke repo — simpan di run.sh lokal (tidak di-versioned).

📦 Struktur

lightbill-mcp-server/
├── README.md
├── LICENSE
├── pyproject.toml
├── server.json              # MCP Registry manifest
├── run.sh                   # shell wrapper (WAJIB untuk FastMCP + Hermes)
├── run.sh.example           # template wrapper
└── lightbill_mcp_server/
    ├── __init__.py
    ├── __main__.py
    └── server.py            # 134 tools FastMCP

🤝 Kontribusi

Silakan buat issue/PR. Semua endpoint API LightBill baru bisa dibungkus dengan mudah — tambahkan @mcp.tool() di server.py.

📄 Lisensi

MIT — lihat LICENSE.