laporan-generator 2.6.2 → 2.8.0

package/.agents/skills/laporan-generator/scripts/test_scripts.py

@@ -1,7 +1,9 @@
 #!/usr/bin/env python3
 """test_scripts.py: Automated unit tests for Laporan Generator Python helper scripts."""
 
+import json
 import os
+import subprocess
 import sys
 import unittest
 
@@ -36,16 +38,39 @@ class TestScanPreset(unittest.TestCase):
         self.assertIn("UNIVERSITAS INDONESIA", inst)
 
 
+def get_presets_dir():
+    for c in [
+        os.path.join(ROOT_DIR, "presets"),
+        os.path.join(ROOT_DIR, "resources", "presets"),
+        os.path.join(ROOT_DIR, "..", "..", "..", "presets"),
+    ]:
+        if os.path.isdir(c):
+            return os.path.abspath(c)
+    return os.path.join(ROOT_DIR, "presets")
+
+
+def get_project_root():
+    for c in [
+        ROOT_DIR,
+        os.path.join(ROOT_DIR, "resources"),
+        os.path.join(ROOT_DIR, "..", "..", ".."),
+    ]:
+        if os.path.isfile(os.path.join(c, "metadata.yml")):
+            return os.path.abspath(c)
+    return ROOT_DIR
+
+
 class TestValidatePreset(unittest.TestCase):
     def test_parse_simple_yaml(self):
-        test_yaml = os.path.join(ROOT_DIR, "presets", "standard.yml")
+        presets_dir = get_presets_dir()
+        test_yaml = os.path.join(presets_dir, "standard.yml")
         self.assertTrue(os.path.exists(test_yaml))
         data = validate_preset.parse_simple_yaml(test_yaml)
         self.assertEqual(data.get("preset_id"), "standard")
         self.assertEqual(data.get("margin_top"), "2cm")
 
     def test_validate_all_presets(self):
-        presets_dir = os.path.join(ROOT_DIR, "presets")
+        presets_dir = get_presets_dir()
         for f in os.listdir(presets_dir):
             if f.endswith(".yml"):
                 path = os.path.join(presets_dir, f)
@@ -98,6 +123,164 @@ class TestFinalizeDocx(unittest.TestCase):
         self.assertEqual(finalize_docx.classify("BAB 2 PEMBAHASAN"), "decimal-start")
         self.assertEqual(finalize_docx.classify("BAB 3 PENUTUP"), "body")
 
+    def test_get_tab_pos(self):
+        sample_standard = '<w:sectPr><w:pgSz w:w="11906"/><w:pgMar w:left="1417" w:right="1417"/></w:sectPr>'
+        self.assertEqual(finalize_docx.get_tab_pos(sample_standard), 9072)
+        sample_4433 = '<w:sectPr><w:pgSz w:w="11906"/><w:pgMar w:left="2268" w:right="1701"/></w:sectPr>'
+        self.assertEqual(finalize_docx.get_tab_pos(sample_4433), 7937)
+        self.assertEqual(finalize_docx.get_tab_pos(""), 9072)
+
+    def test_fix_daftar_isi_title(self):
+        raw = '<w:p><w:pPr><w:pStyle w:val="Heading1"/><w:outlineLvl w:val="-1"/></w:pPr><w:r><w:t>DAFTAR ISI</w:t></w:r></w:p>'
+        fixed = finalize_docx.fix_daftar_isi_title(raw)
+        self.assertIn('w:val="TOCHeading"', fixed)
+        self.assertNotIn('w:val="Heading1"', fixed)
+
+    def test_fix_toc_styles(self):
+        styles = '<w:styles></w:styles>'
+        res = finalize_docx.fix_toc_styles(styles, 7937)
+        self.assertIn('w:styleId="TOCHeading"', res)
+        self.assertIn('w:styleId="TOC1"', res)
+        self.assertIn('w:styleId="TOC2"', res)
+        self.assertIn('w:styleId="TOC3"', res)
+        self.assertIn('w:pos="7937"', res)
+        self.assertIn('w:left="360"', res)
+        self.assertIn('w:left="720"', res)
+
+
+report_stats = __import__("report-stats")
+
+
+class TestReportStats(unittest.TestCase):
+    def test_count_file_stats_structure(self):
+        sample_md = os.path.join(get_project_root(), "cover.md")
+        if os.path.exists(sample_md):
+            stats = report_stats.count_file_stats(sample_md)
+            self.assertIsInstance(stats, dict)
+            self.assertIsInstance(stats["words"], int)
+            self.assertIsInstance(stats["chars"], int)
+            self.assertGreaterEqual(stats["words"], 0)
+
+    def test_json_stats_execution(self):
+        proj_root = get_project_root()
+        cmd = [sys.executable, os.path.join(SCRIPTS_DIR, "report-stats.py"), proj_root, "--json"]
+        proc = subprocess.run(cmd, capture_output=True, text=True, cwd=proj_root)
+        self.assertEqual(proc.returncode, 0)
+        data = json.loads(proc.stdout)
+        self.assertIn("total_words", data)
+        self.assertIn("preset", data)
+        self.assertIn("target_dir", data)
+
+
+class TestReportDoctor(unittest.TestCase):
+    def test_json_doctor_execution(self):
+        proj_root = get_project_root()
+        cmd = [sys.executable, os.path.join(SCRIPTS_DIR, "report-doctor.py"), proj_root, "--json"]
+        proc = subprocess.run(cmd, capture_output=True, text=True, cwd=proj_root)
+        data = json.loads(proc.stdout)
+        self.assertIn("status", data)
+        self.assertIn("dependencies", data)
+        self.assertIn("required_files", data)
+        self.assertIn("citations", data)
+
+
+class TestFrontMatterOptIn(unittest.TestCase):
+    def test_default_metadata_structure(self):
+        meta_path = os.path.join(get_project_root(), "metadata.yml")
+        with open(meta_path, "r", encoding="utf-8") as f:
+            content = f.read()
+        # Verify abstract is commented or empty by default
+        self.assertNotIn("\nabstract_id: |", content, "abstract_id should not be active by default in metadata.yml")
+        self.assertNotIn("\nabstract_en: |", content, "abstract_en should not be active by default in metadata.yml")
+        # Verify opt-in flags for daftar_gambar & daftar_tabel are explicitly false or commented
+        has_dg = "daftar_gambar: false" in content
+        has_dt = "daftar_tabel: false" in content
+        self.assertTrue(has_dg, "metadata.yml must explicitly specify daftar_gambar: false by default")
+        self.assertTrue(has_dt, "metadata.yml must explicitly specify daftar_tabel: false by default")
+
+    def test_cover_md_gated_outlines(self):
+        cover_path = os.path.join(get_project_root(), "cover.md")
+        with open(cover_path, "r", encoding="utf-8") as f:
+            content = f.read()
+        # Unconditional outline queries must not exist
+        self.assertNotIn("let imgs = query(figure.where(kind: image))\n  if imgs.len() > 0", content,
+                         "cover.md must not unconditionally emit DAFTAR GAMBAR outline")
+        self.assertNotIn("let tbls = query(figure.where(kind: table))\n  if tbls.len() > 0", content,
+                         "cover.md must not unconditionally emit DAFTAR TABEL outline")
+        # Must be gated by opt-in check
+        self.assertIn("opt-daftar-gambar", content, "cover.md must gate DAFTAR GAMBAR with opt-daftar-gambar")
+        self.assertIn("opt-daftar-tabel", content, "cover.md must gate DAFTAR TABEL with opt-daftar-tabel")
+
+    def test_lua_meta_bool_coercion(self):
+        """Verify docx.lua handles YAML boolean scalars and string equivalents safely."""
+        lua_code = """
+        local pandoc = {
+          utils = {
+            stringify = function(x)
+              if type(x) ~= 'string' and type(x) ~= 'table' then
+                error('pandoc.utils.stringify expects table or string, got ' .. type(x))
+              end
+              return tostring(x)
+            end
+          }
+        }
+        local function meta_str(meta, key)
+          local v = meta[key]
+          if v == nil then return "" end
+          if type(v) == "boolean" then return tostring(v) end
+          return pandoc.utils.stringify(v)
+        end
+        local function meta_bool(meta, key)
+          local v = meta[key]
+          if v == nil then return false end
+          if type(v) == "boolean" then return v end
+          local s = meta_str(meta, key):lower():gsub("%s+", "")
+          return s == "true" or s == "1" or s == "yes"
+        end
+
+        local meta = {
+          dg_bool_false = false,
+          dg_bool_true = true,
+          dg_str_false = "false",
+          dg_str_true = "true",
+          dg_nil = nil
+        }
+
+        assert(meta_str(meta, "dg_bool_false") == "false")
+        assert(meta_bool(meta, "dg_bool_false") == false)
+        assert(meta_str(meta, "dg_bool_true") == "true")
+        assert(meta_bool(meta, "dg_bool_true") == true)
+        assert(meta_bool(meta, "dg_str_false") == false)
+        assert(meta_bool(meta, "dg_str_true") == true)
+        assert(meta_bool(meta, "dg_nil") == false)
+        print("LUA_OK")
+        """
+        proc = subprocess.run(["lua", "-e", lua_code], capture_output=True, text=True)
+        self.assertEqual(proc.returncode, 0, f"Lua helper test failed: {proc.stderr}")
+        self.assertIn("LUA_OK", proc.stdout)
+
+    def test_init_project_boolean_coercion(self):
+        """Verify lib/init.js does not treat string 'false' as truthy."""
+        import tempfile
+        with tempfile.TemporaryDirectory() as tmpdir:
+            node_code = f"""
+            const path = require('path');
+            const {{ initProject }} = require('{os.path.join(ROOT_DIR, "lib/init.js")}');
+            initProject({{ targetDir: '{tmpdir}/test_f', daftar_gambar: 'false', daftar_tabel: false, silent: true }});
+            initProject({{ targetDir: '{tmpdir}/test_t', daftar_gambar: 'true', daftar_tabel: true, silent: true }});
+            """
+            proc = subprocess.run(["node", "-e", node_code], capture_output=True, text=True)
+            self.assertEqual(proc.returncode, 0, f"Node initProject failed: {proc.stderr}")
+            with open(os.path.join(tmpdir, "test_f", "metadata.yml"), "r", encoding="utf-8") as f:
+                meta_f = f.read()
+            with open(os.path.join(tmpdir, "test_t", "metadata.yml"), "r", encoding="utf-8") as f:
+                meta_t = f.read()
+            self.assertIn("daftar_gambar: false", meta_f)
+            self.assertIn("daftar_tabel: false", meta_f)
+            self.assertIn("daftar_gambar: true", meta_t)
+            self.assertIn("daftar_tabel: true", meta_t)
+
 
 if __name__ == "__main__":
     unittest.main(verbosity=2)
+

package/README.md

@@ -12,6 +12,7 @@
 
 <p align="center">
   <a href="https://www.npmjs.com/package/laporan-generator"><img src="https://img.shields.io/npm/v/laporan-generator?style=for-the-badge&color=cb3837&logo=npm" alt="npm version"></a>
+  <a href="#dukungan-model-context-protocol-mcp"><img src="https://img.shields.io/badge/MCP-Native%20Server-8A2BE2?style=for-the-badge&logo=anthropic" alt="MCP Server"></a>
   <a href="https://github.com/muadzhdz/laporan-generator/actions/workflows/build.yml"><img src="https://github.com/muadzhdz/laporan-generator/actions/workflows/build.yml/badge.svg" alt="Status Build"></a>
   <a href="#"><img src="https://img.shields.io/badge/Typst-0.13+-239DAD?style=for-the-badge&logo=typst&logoColor=white" alt="Typst"></a>
   <a href="#"><img src="https://img.shields.io/badge/Pandoc-3.0+-blue?style=for-the-badge&logo=markdown" alt="Pandoc"></a>
@@ -110,6 +111,48 @@ npx laporan-generator sync-hosts
 
 ---
 
+## Dukungan Model Context Protocol (MCP)
+
+Laporan Generator v2.8.0 dilengkapi dengan **Native MCP Server** resmi yang berjalan melalui `stdio` berbasis protokol JSON-RPC 2.0 (spesifikasi 2024-11-05). Server ini memungkinkan AI Agent otonom (seperti Google Antigravity, Claude Desktop, Claude Code, dan OpenCode) untuk berinteraksi langsung dengan dokumen akademik melalui tools deterministik.
+
+### Konfigurasi Otomatis (Direkomendasikan)
+Cukup jalankan satu perintah berikut untuk mendaftarkan skill sekaligus konfigurasi MCP Server ke seluruh agent di mesin Anda:
+```bash
+npx laporan-generator sync-hosts
+```
+
+Perintah di atas secara aman mendaftarkan server `laporan` tanpa merusak konfigurasi server lain yang sudah ada:
+* **Antigravity CLI**: `~/.gemini/config/mcp_config.json`
+* **Claude Desktop**: `~/.config/Claude/claude_desktop_config.json`
+* **Claude Code**: `~/.claude.json`
+* **OpenCode**: `~/.config/opencode/opencode.jsonc`
+
+### Konfigurasi Manual
+Jika ingin mendaftarkan server secara manual pada klien MCP apa pun:
+```json
+{
+  "mcpServers": {
+    "laporan": {
+      "command": "npx",
+      "args": ["-y", "laporan-generator", "mcp"]
+    }
+  }
+}
+```
+
+### 6 Native Tools MCP yang Disediakan
+
+| Tool Name | Deskripsi Fungsi | Parameter Utama |
+|---|---|---|
+| `laporan_init` | Menginisialisasi dokumen baru (skripsi/makalah) secara terprogram | `target_dir`, `title`, `author`, `nim`, `institution`, `preset` |
+| `laporan_doctor` | Mengaudit integritas dependensi, berkas wajib, sitasi, dan broken media | `target_dir`, `fix` (opsional) |
+| `laporan_stats` | Menghitung statistik kata, bab, karakter, dan estimasi halaman | `target_dir` |
+| `laporan_presets` | Memeriksa daftar dan detail konfigurasi preset kampus resmi | `action` (`list` / `get`), `preset_id` |
+| `laporan_citations` | Memvalidasi integritas BibTeX dan pencarian sitasi langsung ke Crossref API | `action` (`validate` / `search`), `query`, `bib_path` |
+| `laporan_build` | Mengompilasi dokumen ke PDF (Typst) dan/atau DOCX (Word) | `format` (`all` / `pdf` / `docx`), `preset` |
+
+---
+
 ## Alur Penggunaan Cepat
 
 ### Opsi A: Alur Otonom AI Agent via NPX (Direkomendasikan)
@@ -192,6 +235,7 @@ Seluruh perintah didukung secara konsisten di NPX, Linux/macOS Bash (`./laporan`
 
 | Perintah | NPX (`npx laporan-generator`) | Bash (`./laporan`) | PowerShell (`.\laporan.ps1`) | Keterangan Fungsi |
 |---|---|---|---|---|
+| `mcp` | Didukung | Didukung | Didukung | Menjalankan Model Context Protocol (MCP) Server untuk AI Agent |
 | `init` | Didukung | Didukung | Didukung | Menyalin template berkas, metadata, dan draf bab awal |
 | `sync-hosts` | Didukung | Didukung | Didukung | Memasang skill ke seluruh direktori agen AI yang terdeteksi |
 | `setup` | Didukung | Didukung | Didukung | Memasang paket sistem Typst, Pandoc, ImageMagick, dan Python |
@@ -249,6 +293,11 @@ title: "Analisis dan Implementasi Sistem Deteksi Intrusi Jaringan Berbasis eBPF"
 document_type: "Skripsi"
 margin_preset: "itb-ta"
 
+# Kontrol Struktur Halaman Depan (Opt-In)
+# Default struktur bersih: Cover -> Kata Pengantar -> Daftar Isi -> Batang Tubuh -> Daftar Pustaka
+daftar_gambar: false   # Ubah true jika dokumen memuat gambar dan membutuhkan DAFTAR GAMBAR
+daftar_tabel: false    # Ubah true jika dokumen memuat tabel dan membutuhkan DAFTAR TABEL
+
 author:
   - name: "Mu'adz Hudzaifah"
     nim: "13522001"

package/bin/laporan-generator.js

@@ -25,23 +25,29 @@ function showHelp() {
   ========================================================
          LAPORAN GENERATOR CLI (Multi-Host AI Engine)     
   ========================================================
-  Versi: 2.6.2
+  Versi: 2.8.0
   
   Penggunaan:
     npx laporan-generator <perintah> [opsi]
 
   Perintah Utama:
-    sync-hosts        Pasang/sinkronkan AI agent skills ke Antigravity, Claude, Grok
+    mcp               Jalankan Model Context Protocol (MCP) Server untuk AI Agent
+    sync-hosts        Pasang/sinkronkan AI agent skills & MCP ke Antigravity, Claude, OpenCode
     uninstall         Hapus/bersihkan skill dan perintah dari seluruh AI agent host
     setup             Jalankan installer dependensi otomatis multi-OS (Typst, Pandoc, ImageMagick)
     init              Inisialisasi template dokumen laporan/skripsi di direktori saat ini
     doctor            Audit kesehatan lingkungan dan dependensi dokumen
+    stats             Hitung statistik komprehensif dokumen (kata, bab, estimasi halaman)
     build             Kompilasi dokumen ke PDF dan DOCX
     help              Tampilkan panduan ini
   `);
 }
 
 switch (command) {
+  case 'mcp':
+  case 'server':
+    require('../lib/mcp').start();
+    break;
   case 'uninstall':
   case 'clean-skills':
     require('../lib/uninstall').run(args.slice(1));
@@ -57,11 +63,17 @@ switch (command) {
   case 'init':
     require('../lib/init').run(args.slice(1));
     break;
+  case 'stats':
+    const statsScript = path.join(__dirname, '../scripts/report-stats.py');
+    const pyStatsCmd = getPythonCommand();
+    const statsProc = spawnSync(pyStatsCmd, [statsScript, ...args.slice(1)], { stdio: 'inherit' });
+    process.exit(statsProc.status || 0);
+    break;
   case 'doctor':
   case 'check':
     const doctorScript = path.join(__dirname, '../scripts/report-doctor.py');
     const pyCmd = getPythonCommand();
-    const proc = spawnSync(pyCmd, [doctorScript], { stdio: 'inherit' });
+    const proc = spawnSync(pyCmd, [doctorScript, ...args.slice(1)], { stdio: 'inherit' });
     process.exit(proc.status || 0);
     break;
   case 'build':

package/bin/mcp-server.js

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+"use strict";
+
+require("../lib/mcp").start();

package/cover.md

@@ -22,21 +22,25 @@ Penulis menyadari bahwa laporan ini masih jauh dari sempurna. Oleh karena itu, k
   depth: 3,
 )
 #context {
-  let imgs = query(figure.where(kind: image))
-  if imgs.len() > 0 {
-    pagebreak()
-    outline(
-      title: align(center)[#text(size: 14pt, weight: "bold")[DAFTAR GAMBAR]],
-      target: figure.where(kind: image),
-    )
+  if opt-daftar-gambar {
+    let imgs = query(figure.where(kind: image))
+    if imgs.len() > 0 {
+      pagebreak()
+      outline(
+        title: align(center)[#text(size: 14pt, weight: "bold")[DAFTAR GAMBAR]],
+        target: figure.where(kind: image),
+      )
+    }
   }
-  let tbls = query(figure.where(kind: table))
-  if tbls.len() > 0 {
-    pagebreak()
-    outline(
-      title: align(center)[#text(size: 14pt, weight: "bold")[DAFTAR TABEL]],
-      target: figure.where(kind: table),
-    )
+  if opt-daftar-tabel {
+    let tbls = query(figure.where(kind: table))
+    if tbls.len() > 0 {
+      pagebreak()
+      outline(
+        title: align(center)[#text(size: 14pt, weight: "bold")[DAFTAR TABEL]],
+        target: figure.where(kind: table),
+      )
+    }
   }
 }
 #pagebreak()

package/docs/metadata-schema.md

@@ -49,6 +49,8 @@ abstract: |
 | `faculty` | String | **Ya** | Nama Fakultas, Departemen, atau Program Studi. |
 | `year` | String | **Ya** | Tahun Ajaran (contoh: `2025/2026`). |
 | `date` | String | Opsional | Bulan dan Tahun pembuatan (contoh: `Juli 2026`). |
+| `daftar_gambar` | Boolean | Opsional | Aktifkan halaman DAFTAR GAMBAR (`true`/`false`, default: `false`). |
+| `daftar_tabel` | Boolean | Opsional | Aktifkan halaman DAFTAR TABEL (`true`/`false`, default: `false`). |
 | `abstract` | Multiline String | Opsional | Ringkasan/Abstrak laporan dalam Bahasa Indonesia. |
 
 ---

package/docx.lua

@@ -138,9 +138,24 @@ local function meta_str(meta, key)
   if v == nil then
     return ""
   end
+  if type(v) == "boolean" then
+    return tostring(v)
+  end
   return pandoc.utils.stringify(v)
 end
 
+local function meta_bool(meta, key)
+  local v = meta[key]
+  if v == nil then
+    return false
+  end
+  if type(v) == "boolean" then
+    return v
+  end
+  local s = meta_str(meta, key):lower():gsub("%s+", "")
+  return s == "true" or s == "1" or s == "yes"
+end
+
 local function format_chapter_number(n)
   if chapter_num_fmt == "arabic" then
     return tostring(n)
@@ -280,6 +295,44 @@ local function daftar_isi()
   return out
 end
 
+local function daftar_gambar()
+  local out = pandoc.List{}
+  out[#out + 1] = pagebreak()
+  out[#out + 1] = pandoc.RawBlock(
+    "openxml",
+    '<w:p><w:pPr><w:pStyle w:val="TOCHeading"/><w:jc w:val="center"/><w:outlineLvl w:val="9"/></w:pPr>' ..
+      '<w:r><w:rPr><w:b/><w:sz w:val="28"/><w:szCs w:val="28"/></w:rPr><w:t>DAFTAR GAMBAR</w:t></w:r></w:p>'
+  )
+  out[#out + 1] = pandoc.RawBlock(
+    "openxml",
+    '<w:p><w:pPr><w:pStyle w:val="TOC1"/></w:pPr>' ..
+      '<w:r><w:fldChar w:fldCharType="begin" w:dirty="true"/></w:r>' ..
+      '<w:r><w:instrText xml:space="preserve"> TOC \\c "Gambar" \\h \\z </w:instrText></w:r>' ..
+      '<w:r><w:fldChar w:fldCharType="separate"/></w:r>' ..
+      '<w:r><w:fldChar w:fldCharType="end"/></w:r></w:p>'
+  )
+  return out
+end
+
+local function daftar_tabel()
+  local out = pandoc.List{}
+  out[#out + 1] = pagebreak()
+  out[#out + 1] = pandoc.RawBlock(
+    "openxml",
+    '<w:p><w:pPr><w:pStyle w:val="TOCHeading"/><w:jc w:val="center"/><w:outlineLvl w:val="9"/></w:pPr>' ..
+      '<w:r><w:rPr><w:b/><w:sz w:val="28"/><w:szCs w:val="28"/></w:rPr><w:t>DAFTAR TABEL</w:t></w:r></w:p>'
+  )
+  out[#out + 1] = pandoc.RawBlock(
+    "openxml",
+    '<w:p><w:pPr><w:pStyle w:val="TOC1"/></w:pPr>' ..
+      '<w:r><w:fldChar w:fldCharType="begin" w:dirty="true"/></w:r>' ..
+      '<w:r><w:instrText xml:space="preserve"> TOC \\c "Tabel" \\h \\z </w:instrText></w:r>' ..
+      '<w:r><w:fldChar w:fldCharType="separate"/></w:r>' ..
+      '<w:r><w:fldChar w:fldCharType="end"/></w:r></w:p>'
+  )
+  return out
+end
+
 function Pandoc(doc)
   if FORMAT ~= "docx" then
     return doc
@@ -292,6 +345,8 @@ function Pandoc(doc)
   local faculty = meta_str(meta, "faculty")
   local institution = meta_str(meta, "institution")
   local year = meta_str(meta, "year")
+  local show_dg = (meta_bool(meta, "daftar_gambar") or meta_bool(meta, "list_of_figures"))
+  local show_dt = (meta_bool(meta, "daftar_tabel") or meta_bool(meta, "list_of_tables"))
 
   local blocks = pandoc.List{}
 
@@ -401,6 +456,16 @@ function Pandoc(doc)
       for _, b in ipairs(daftar_isi()) do
         body[#body + 1] = b
       end
+      if show_dg then
+        for _, b in ipairs(daftar_gambar()) do
+          body[#body + 1] = b
+        end
+      end
+      if show_dt then
+        for _, b in ipairs(daftar_tabel()) do
+          body[#body + 1] = b
+        end
+      end
       inserted = true
     end
     body[#body + 1] = blk

package/laporan

@@ -27,7 +27,7 @@ export PYTHONUTF8=1
 show_banner() {
     echo -e "${CYAN}${BOLD}"
     echo "  ========================================================"
-    echo "                 LAPORAN GENERATOR CLI v2.6.2             "
+    echo "                 LAPORAN GENERATOR CLI v2.8.0             "
     echo "     Otomatisasi Dokumen Akademik (Typst + DOCX Engine)   "
     echo "  ========================================================"
     echo -e "${NC}"
@@ -38,6 +38,7 @@ show_help() {
     echo -e "${BOLD}Penggunaan:${NC} ./laporan <perintah>"
     echo ""
     echo -e "${BOLD}Perintah yang Tersedia:${NC}"
+    echo -e "  ${GREEN}mcp${NC}          Jalankan Model Context Protocol (MCP) Server untuk AI Agent"
     echo -e "  ${GREEN}build${NC}        Kompilasi PDF dan DOCX sekaligus"
     echo -e "  ${GREEN}pdf${NC}          Kompilasi dokumen PDF (via Typst)"
     echo -e "  ${GREEN}docx${NC}         Kompilasi dokumen Microsoft Word (.docx)"
@@ -47,7 +48,7 @@ show_help() {
     echo -e "  ${GREEN}doctor${NC}       Audit kesehatan proyek (broken images, sitasi hilang, dll.)"
     echo -e "  ${GREEN}bundle${NC}       Kemas seluruh laporan (PDF, DOCX, MD) menjadi arsip zip"
     echo -e "  ${GREEN}setup${NC}        Pasang dependensi sistem otomatis (Linux, macOS, Nix, Docker)"
-    echo -e "  ${GREEN}sync-skills${NC}  Sinkronkan skill AI agent ke Antigravity, Claude, Grok"
+    echo -e "  ${GREEN}sync-skills${NC}  Sinkronkan skill AI agent & MCP ke Antigravity, Claude, OpenCode"
     echo -e "  ${GREEN}uninstall${NC}    Hapus integrasi skill dan perintah AI agent dari seluruh sistem"
     echo -e "  ${GREEN}check${NC}        Audit dependensi sistem dan struktur proyek"
     echo -e "  ${GREEN}test${NC}         Jalankan suite pengujian otomatis (test.sh)"
@@ -424,16 +425,48 @@ case "${1:-help}" in
     setup)
         bash scripts/setup-deps.sh
         ;;
+    mcp|server)
+        shift
+        if command -v node >/dev/null 2>&1; then
+            if [ -f "bin/mcp-server.js" ]; then
+                node bin/mcp-server.js "$@"
+            elif command -v npx >/dev/null 2>&1; then
+                npx -y laporan-generator mcp "$@"
+            else
+                echo "Berkas bin/mcp-server.js tidak ditemukan dan npx tidak tersedia."
+                exit 1
+            fi
+        else
+            echo "Node.js diperlukan untuk menjalankan MCP Server."
+            exit 1
+        fi
+        ;;
     sync-skills|sync-hosts)
+        shift
         if command -v node >/dev/null 2>&1; then
-            node bin/laporan-generator.js sync-hosts
+            if [ -f "bin/laporan-generator.js" ]; then
+                node bin/laporan-generator.js sync-hosts "$@"
+            elif command -v npx >/dev/null 2>&1; then
+                npx -y laporan-generator sync-hosts "$@"
+            else
+                echo "Berkas bin/laporan-generator.js tidak ditemukan dan npx tidak tersedia."
+                exit 1
+            fi
         else
             echo "Node.js diperlukan untuk sinkronisasi multi-host AI agent."
         fi
         ;;
     uninstall|clean-skills)
+        shift
         if command -v node >/dev/null 2>&1; then
-            node bin/laporan-generator.js uninstall
+            if [ -f "bin/laporan-generator.js" ]; then
+                node bin/laporan-generator.js uninstall "$@"
+            elif command -v npx >/dev/null 2>&1; then
+                npx -y laporan-generator uninstall "$@"
+            else
+                echo "Berkas bin/laporan-generator.js tidak ditemukan dan npx tidak tersedia."
+                exit 1
+            fi
         else
             echo "Node.js diperlukan untuk membersihkan integrasi AI agent."
         fi