MCP Bridge

Satu tool kecil di laptopmu yang bikin Claude (atau AI lain) bisa lihat server, baca database, dan bantu migrasi data — tanpa kamu copy-paste log lagi.

Cocok buat siapa? Developer, DevOps, atau siapa saja yang sering kerja dengan server jarak jauh dan capek bolak-balik terminal ↔ chat AI.

Butuh apa di laptop?

• Node.js versi 20 atau lebih baru (download di sini)
• Akses ke server (lewat SSH) atau database yang mau dicolok

Itu saja. Tidak perlu Docker, tidak perlu daftar akun, tidak perlu kartu kredit.

🚀 5 Menit Pertama (Quick Start)

Langkah 1 — Install

Buka terminal (di Mac: cari "Terminal", di Windows: "PowerShell", di Linux: kamu pasti tahu), lalu ketik:

npx @ariansyah_akbar_pinisidev/mcp-bridge init

Apa yang terjadi? Tool ini akan tanya 3-4 hal pakai bahasa manusia (nama project, di mana mau simpan config, password untuk amankan kredensialmu). Jawab saja apa adanya. Selesai dalam 1 menit.

Langkah 2 — Tambah server pertamamu

npx @ariansyah_akbar_pinisidev/mcp-bridge add-host

Tool akan tanya:

| Pertanyaan | Contoh jawaban | |---|---| | Nama server (bebas, asal kamu inget) | vps-toko-online | | Alamat IP atau hostname | 192.168.1.100 atau myserver.com | | Username SSH | root atau ubuntu | | Pakai password atau SSH key? | Pilih yang kamu punya | | Level akses server ini | Pilih readonly kalau ragu |

Tips: Mulai dengan readonly dulu untuk server production. Naikkan ke safe-write kalau sudah yakin. Jangan langsung full-sudo di server live.

Ulangi langkah ini untuk setiap server yang mau didaftarkan. Bisa 1, 5, atau 50 server.

Langkah 3 — Sambungkan ke Claude Code (atau IDE lain)

Buka file config Claude Code-mu. Lokasinya:

• Mac: ~/.config/claude-code/mcp.json
• Windows: %APPDATA%\claude-code\mcp.json
• Linux: ~/.config/claude-code/mcp.json

Tambahkan ini di dalamnya:

{
  "mcpServers": {
    "bridge": {
      "command": "npx",
      "args": ["@ariansyah_akbar_pinisidev/mcp-bridge", "start"]
    }
  }
}

Restart Claude Code. Selesai. Sekarang tinggal ngobrol biasa:

"Coba lihat status server vps-toko-online, ada error di log nginx ga?"

Claude akan otomatis pakai MCP Bridge untuk SSH ke server itu, baca lognya, lalu jawab ke kamu.

🧰 Menjalankan Secara Lokal (Clone & Develop)

Catatan singkat untuk developer:

Karena paket ini akan dipublish ke npm, pengguna biasa cukup menjalankan:

npx @ariansyah_akbar_pinisidev/mcp-bridge init

Jika kamu clone repo ini untuk pengembangan lokal, cukup npm install, npm run build, lalu gunakan npm link atau npm run start sesuai kebutuhan.

Error seperti mcp-bridge: command not found hanya relevan bagi yang menjalankan dari source (clone); setelah paket dipublish ke npm, npx @ariansyah_akbar_pinisidev/mcp-bridge init akan bekerja untuk semua pengguna.

📚 Yang Bisa Dilakukan MCP Bridge

Aku jelaskan dengan contoh kalimat yang bisa kamu ketik ke Claude. Tidak perlu hafal nama tool — Claude yang pilih.

🖥️ Urusan Server (SSH)

| Kamu bilang... | MCP Bridge melakukan... | |---|---| | "Cek disk space di server prod-api" | SSH ke server, jalankan df -h, ringkas hasilnya | | "Tail log nginx 100 baris terakhir di vps-toko" | Baca log, filter ERROR/WARN, kirim ringkasannya | | "Restart service nginx di staging" | (Kalau policy izinkan) jalankan sudo systemctl restart nginx | | "Upload file ini ke /etc/nginx/conf.d/ di server X" | Pakai SFTP, tanya konfirmasi sebelum overwrite | | "Server prod kenapa lambat?" | Cek CPU, RAM, disk I/O, top processes, kasih analisa |

🗄️ Urusan Database

| Kamu bilang... | MCP Bridge melakukan... | |---|---| | "Lihat tabel apa saja di DB lama" | Introspect schema, list tables + jumlah row | | "Berapa user terdaftar bulan ini?" | Jalankan SELECT yang aman (read-only) | | "Cari di Mongo, dokumen yang punya field 'archived'" | Query MongoDB | | "Ada apa di koleksi vector Qdrant?" | List collections, dimensi vector, jumlah point |

🔄 Migrasi Database (Fitur Andalan)

Ini bukan migrasi sembarangan. Sistem akan stop dan tanya kamu kalau ada keanehan. Tidak ada "auto-magic" yang bisa bikin data corrupt.

Cara pakai: Cukup bilang ke Claude:

"Migrasiin data dari MySQL lama ke PostgreSQL baru. Server lama: db-old, server baru: db-new."

Claude (lewat MCP Bridge) akan jalanin 5 fase wajib:

Fase 1: Baca & analisa DB lama        → kamu approve ✅
Fase 2: Baca & analisa DB baru        → kamu approve ✅
Fase 3: Bikin rencana migrasi
         + tanya kamu kalau ada       → kamu jawab pertanyaannya ✅
           hal yang membingungkan
Fase 4: Coba migrasi 1000 row sample
         (TIDAK nulis ke DB baru)     → kamu approve hasilnya ✅
Fase 5: Migrasi beneran + verify      → selesai ✅

Contoh pertanyaan yang akan ditanya di Fase 3:

"Field address di MongoDB lama itu objek bersarang (embedded). Mau aku flatten jadi 3 kolom (address_street, address_city, address_zip) atau bikin tabel addresses terpisah? Saran saya: kalau alamat user cuma 1 dan tidak pernah berubah-ubah → flatten lebih simpel. Kalau bisa multiple alamat atau riwayatnya penting → tabel terpisah lebih bener."

Kamu jawab → migrasi lanjut. Tidak akan pernah ada keputusan diam-diam soal data kamu.

🐳 Urusan Docker

| Kamu bilang... | MCP Bridge melakukan... | |---|---| | "Container apa saja yang jalan di server prod?" | List containers + status | | "Tampilin log container nginx 50 baris terakhir" | docker logs --tail 50 lalu ringkas | | "Deploy ulang docker-compose di folder /apps/api" | compose down lalu compose up -d (kalau policy izinkan) | | "Container database kenapa restart terus?" | Cek logs + inspect, kasih analisa |

☸️ Urusan Kubernetes

| Kamu bilang... | MCP Bridge melakukan... | |---|---| | "Pod apa saja yang lagi crash?" | List pods status CrashLoopBackOff | | "Logs pod api-server-xxx" | Stream logs ringkasan | | "Apply file deployment ini" | (Policy ketat) konfirmasi dulu, baru apply |

🧠 Senior Brain Mode — Bikin Model Murah Jago

TL;DR: Pakai model AI gratisan/termurah (Haiku, GPT-4o-mini, Llama lokal) tapi hasil analisanya kayak senior engineer 15 tahun. Token hemat 80-95%.

Kenapa bisa? Karena MCP Bridge mengerjakan analisanya sendiri di laptopmu — AI cuma bertugas terjemahin hasilnya jadi kalimat enak dibaca.

Contoh konkret

Kamu bilang: "Server vps-toko lambat banget, kenapa ya?"

Tanpa Senior Brain Mode (model murah):

• AI SSH, jalanin top, baca outputnya, narasi panjang yang dangkal
• Token boros, jawaban kayak: "CPU lagi tinggi, sepertinya ada proses yang berat"
• Tidak ada solusi konkret

Dengan Senior Brain Mode:

1. MCP Bridge jalanin playbook diagnose_slow_server → 8 command paralel (uptime, free, df, iostat, ps, ss, dmesg)
2. Output mentah di-parse di laptopmu, di-rank, dideteksi pattern-nya
3. Kirim ke AI cuma JSON terstruktur ~500 token (bukan 10.000 token raw)
4. AI cuma terjemahin, jawabannya jadi:

"Server lambat karena pg_dump (PID 4521) ngehog disk I/O — wait time 78%. Sudah berjalan 47 menit. Saran: 1. Pause sekarang: kill -STOP 4521 (aman, bisa di-resume) 2. Restart dengan ionice: ionice -c3 pg_dump ... 3. Schedule backup di jam sepi Jangan kill -9 sebelum cek apakah backup ini penting."

3 Mode pilihan

# Set di config kamu, atau pakai flag --mode
mode: economy    # Default. Ringkas total. Cocok model murah.
mode: balanced   # Lebih detail. Cocok model menengah.
mode: verbose    # Output lengkap + raw. Cocok debug mendalam.

Yang bikin Senior Brain Mode jago

| Pilar | Apa fungsinya | |---|---| | Playbook | ~15 resep diagnostic siap pakai (slow server, OOM, slow query, pod crashloop, dll) | | Pattern Library | 50+ pola error otomatis dikenali (deadlock, OOM kill, upstream timeout, dll) | | Smart Compression | Log 5000 baris → 50 cluster + 8 pattern terdeteksi (~98% reduction) | | Diagnosis Format | Output ke AI selalu terstruktur: TLDR + evidence + actions + warnings | | Knowledge Base | ~30 file markdown senior tips di-inject otomatis sesuai context |

KISS: Semua itu cuma kode TypeScript biasa + regex + markdown. Mentee bisa nambah playbook/pattern baru dengan PR 1 file.

Mau tambah playbook sendiri?

Bikin file di ~/.mcp-bridge/playbooks/my-playbook.ts:

export default {
  name: 'check_redis_health',
  steps: [
    { cmd: 'redis-cli INFO memory',  weight: 'memory' },
    { cmd: 'redis-cli INFO clients', weight: 'connections' },
    { cmd: 'redis-cli SLOWLOG GET 10', weight: 'slow_ops' },
  ],
};

Restart MCP Bridge → playbookmu otomatis terdaftar. Selesai.

🔐 Soal Keamanan (Tenang, Aman)

Apakah kredensial server saya aman?

Ya. Disimpan terenkripsi (AES-256-GCM) di laptop kamu sendiri. Tidak ada server kami — tidak ada cloud, tidak ada upload, tidak ada langganan. Kalau kamu hapus folder config, semua data hilang dari muka bumi.

Apakah Claude bisa "lari" jalanin perintah berbahaya?

Tidak. Setiap server punya policy level:

| Level | Yang dibolehkan | Yang dilarang | |---|---|---| | readonly | Baca log, query DB (SELECT), list container | TIDAK BISA tulis apapun | | safe-write | Restart service, deploy compose | rm -rf, DROP DATABASE, TRUNCATE di-block | | full-sudo | Apa saja | (kamu yang tanggung jawab) |

Plus, command bahaya seperti rm -rf /, DROP DATABASE, TRUNCATE, kubectl delete selalu butuh konfirmasi eksplisit dari kamu — kecuali server tersebut dev-local.

Bisa lihat apa saja yang sudah dijalankan?

Bisa. Semua tercatat di ~/.mcp-bridge/audit.log. Setiap tool call, kapan, server mana, hasilnya apa.

🛠️ Kalau Ada Masalah

"Claude bilang tool tidak ditemukan"

Restart Claude Code. Kalau masih tidak muncul, cek file config-nya sudah benar dengan jalankan:

npx @ariansyah_akbar_pinisidev/mcp-bridge doctor

Tool ini akan cek satu per satu: Node version, config file, kredensial, koneksi ke setiap server. Kasih tahu di mana yang error.

"Connection timeout ke server"

Coba SSH manual dulu dari terminal:

ssh username@ip-server

Kalau manual aja gagal → masalah di network/firewall, bukan MCP Bridge. Kalau manual sukses tapi MCP Bridge gagal, jalankan doctor (lihat di atas).

"Lupa password kredensial vault"

Tidak bisa di-recover (itu fitur, bukan bug — namanya enkripsi). Jalankan:

npx @ariansyah_akbar_pinisidev/mcp-bridge reset

Lalu daftar ulang servermu. Cuma butuh 5 menit kalau punya beberapa server.

"Mau hapus satu server dari daftar"

npx @ariansyah_akbar_pinisidev/mcp-bridge remove-host nama-server

"Mau lihat semua server yang sudah didaftar"

npx @ariansyah_akbar_pinisidev/mcp-bridge list-hosts

🌐 Pakai di IDE Lain (Bukan Claude Code)

Codex CLI

Edit ~/.codex/config.toml:

[mcp_servers.bridge]
command = "npx"
args = ["@ariansyah_akbar_pinisidev/mcp-bridge", "start"]

Antigravity / Cursor / IDE lainnya

Cari setting "MCP Servers" di IDE-mu, lalu masukkan:

• Command: npx
• Args: @ariansyah_akbar_pinisidev/mcp-bridge start

Banyak IDE sekaligus (HTTP mode)

Kalau mau satu MCP Bridge dipakai banyak IDE bersamaan:

npx @ariansyah_akbar_pinisidev/mcp-bridge start --http --port 3737

Lalu di tiap IDE, arahkan MCP server ke http://127.0.0.1:3737/mcp.

⚠️ Default cuma bisa diakses dari laptop yang sama. Kalau mau dibuka ke jaringan lain (tidak disarankan), pakai flag --unsafe-listen-all.

📋 Cheat Sheet Perintah CLI

# Setup awal (sekali aja)
npx @ariansyah_akbar_pinisidev/mcp-bridge init

# Tambah server baru
npx @ariansyah_akbar_pinisidev/mcp-bridge add-host

# Lihat daftar server
npx @ariansyah_akbar_pinisidev/mcp-bridge list-hosts

# Hapus server
npx @ariansyah_akbar_pinisidev/mcp-bridge remove-host nama-server

# Jalankan MCP server (biasanya dipanggil otomatis sama IDE)
npx @ariansyah_akbar_pinisidev/mcp-bridge start

# Mode HTTP (banyak IDE sekaligus)
npx @ariansyah_akbar_pinisidev/mcp-bridge start --http --port 3737

# Cek kalau ada masalah
npx @ariansyah_akbar_pinisidev/mcp-bridge doctor

# Lihat audit log
npx @ariansyah_akbar_pinisidev/mcp-bridge logs

# Reset semua (hati-hati, hapus semua kredensial)
npx @ariansyah_akbar_pinisidev/mcp-bridge reset

🤔 FAQ

Q: Apakah ini gratis? A: Ya, gratis dan open-source. Tidak ada langganan, tidak ada akun.

Q: Data saya dikirim kemana? A: Tidak kemana-mana. MCP Bridge jalan di laptopmu sendiri. Yang dikirim ke Claude (atau LLM lain) cuma hasil tool yang sudah diringkas.

Q: Kalau Claude tiba-tiba "salah ngerti" dan jalanin perintah berbahaya? A: Tidak bisa. Policy engine + blocked commands akan menolak. Untuk command sensitif, akan minta konfirmasi kamu dulu.

Q: Saya pemula, tidak tahu apa itu MCP. Apa harus belajar? A: Tidak perlu. Anggap MCP itu "colokan" yang bikin AI bisa pakai tool. Selama kamu ikuti 3 langkah Quick Start di atas, sudah jalan.

Q: Saya punya 50 server. Sanggup? A: Sanggup. Connection pool akan handle. Tapi inventory file-mu akan panjang — pakai list-hosts untuk navigasi.

Q: Bisa pakai SSH agent (ssh-agent) yang sudah jalan? A: Bisa. Saat add-host, pilih "use existing SSH agent". Tidak perlu masukin password lagi.

Q: Bisa connect database lewat SSH tunnel? A: Bisa. Saat add-host untuk database, ada opsi "connect via SSH host". Pilih nama server SSH yang sudah didaftar, MCP Bridge akan otomatis tunnel.

Q: Ada batas jumlah migrasi? A: Tidak. Tapi tiap migrasi disimpan checkpoint-nya di ~/.mcp-bridge/migrations/. Kalau ribuan migrasi, folder bisa besar — bersihkan manual kalau perlu.

Q: Bisa pakai bahasa Indonesia ke Claude untuk operasinya? A: Bisa banget. MCP Bridge tidak peduli bahasa — yang penting Claude paham maksudmu, dan dia tahu kapan panggil tool.

Q: Saya pakai model AI murah/gratis (Haiku, GPT-4o-mini, Llama lokal). Kualitasnya jelek? A: Justru ini sweet spot MCP Bridge. Senior Brain Mode bikin output sekualitas senior 15 tahun bahkan dengan model termurah, karena analisanya dikerjakan di laptopmu sendiri. AI cuma bertugas nerjemahin hasil. Token hemat 80-95% pula.

Q: Bisa nambah playbook atau pattern sendiri? A: Bisa. Drop file di ~/.mcp-bridge/playbooks/ atau ~/.mcp-bridge/patterns/, restart, langsung jalan. Tidak perlu rebuild atau publish.

📞 Butuh Bantuan?

• Masalah teknis: jalankan npx @ariansyah_akbar_pinisidev/mcp-bridge doctor dulu, kebanyakan masalah ketauan dari situ
• Bug atau request fitur: buka issue di repo GitHub
• Belajar lebih dalam: ada docs/ folder dengan penjelasan tiap modul

Filosofi tool ini: Sederhana untuk dipakai. Aman secara default. Otaknya di server, bukan di model. Kalau ragu, sistem yang nanya — bukan kamu yang harus tebak.

Selamat ngoding tanpa copy-paste log lagi 🎉