🚀 Offline · Protokol MCP · Tanpa API

mcp-rag-memory

Memori jangka panjang untuk AI kamu 🧠
RAG + manajemen konteks — offline penuh, tanpa API key!

Nodejs

TS TypeScript

SQL SQLite

19 Tools

Bisa offline

🦸Siapa bosnya?

✨Fungsi utama

⚡Mulai cepat

npm install
npm test                 # 160 cek: unit + round-trip MCP
npm run lint             # oxlint
npm run build            # kompilasi ke dist/
npm run cli -- docs      # playground CLI
npx mcp-rag-memory       # langsung jalan dari npm (butuh Node >= 22.12)

🌍Satu memori, semua agent

🧩 Tips: perintah sama di mana saja — npx mcp-rag-memory setelah `npm install -g` / publish, atau node --import tsx <path>/src/mcp/rag-server.ts buat dev lokal. Ingat sekali, panggil di mana saja!

🧰19 Tools MCP

Grup	Tool	Fungsi
Sistem	system_stats	Lokasi DB, backend embedding, jumlah dok/memori
RAG Input	rag_ingest_text	Simpan teks mentah (deteksi dobel otomatis)
	rag_ingest_file	Simpan sebuah file
	rag_ingest_dir	Input satu folder penuh!
RAG Cari	rag_search	Cari hybrid (BM25 + vektor), chunk terurut
	rag_retrieve	Blok konteks siap-suntik
RAG Dokumen	rag_list_documents	Inventaris dokumen (ada limit/offset)
	rag_document_stats	Jumlah dokumen & chunk
	rag_delete_document	Hapus dokumen + chunk
Sinkron Sesi	rag_sync_session	Input sesi opencode masuk store RAG
Memori	memory_remember	Simpan memori jangka panjang
	memory_recall	Cari memori semantik
	memory_context	Blok ringkas untuk prompt
	memory_list/get/update/forget	CRUD lengkap
	memory_consolidate	Dedupe + promosi memori panas
	memory_stats	Jumlah, token, rata-rata penting

💾Input sesi tersimpan otomatis

Setiap pesan yang kamu ketik di opencode bisa ikut masuk store RAG sebagai dokumen yang bisa dicari — tanpa mencampur memori jangka panjang yang kurasi.

# plugin ".opencode/plugin/session-logger.ts" auto-sync tiap menit (RAG_AUTOSYNC=0 utk matikan)
npm run sync-latest -- --dir "D:/Project/my-app"   # sesi terbaru di workspace itu
npm run sync-session -- ses_abc123                  # sesi tertentu
npm run cli -- sessions                             # daftar sesi terbuka

Data dibaca dari DB opencode sendiri (~/.local/share/opencode/opencode.db), aman karena dedup per (source, sesi, timestamp) — jalan berulang-ulang tidak bikin dobel, tapi pesan sama di sesi berbeda tetap jadi dokumen terpisah. Input panjang otomatis dipadatkan ke point inti (ekstraktif, tanpa LLM) supaya storage ramping; ketik ulang tetap utuh. Tool MCP rag_sync_session nyediain akses yang sama lewat MCP.

🏗️Arsitektur

🍪 Data tersimpan di .rag-data/rag.sqlite (di-gitignore, memori tidak pernah ter-push!)

🎛️Konfigurasi

🔥 opencode (global)

{
  "mcp": {
    "rag-memory": {
      "type": "local",
      "command": ["node", "--import", "tsx", "src/mcp/rag-server.ts"],
      "cwd": "D:/Project/mcp-server",
      "environment": { "RAG_DB_DIR": "D:/Project/mcp-server/.rag-data" }
    }
  }
}

🟣 Claude Desktop

{
  "mcpServers": {
    "rag-memory": {
      "command": "node",
      "args": ["--import", "tsx", "D:/Project/mcp-server/src/mcp/rag-server.ts"],
      "env": { "RAG_DB_DIR": "D:/Project/mcp-server/.rag-data" }
    }
  }
}

🔧 Variabel lingkungan penting

Variabel	Default	Guna
RAG_DB_DIR	.rag-data	Lokasi penyimpanan SQLite
SEARCH_MODE	hybrid	hybrid | vector | keyword
EMBEDDING_PROVIDER	local	local (tanpa deps) | transformers
RAG_MAX_FILE_MB	10	Batas ukuran file yang boleh di-ingest
RAG_ALLOWED_DIRS	(bebas)	Daftar folder yang diizinkan: ; | ,
RAG_PRUNE	0	1 = konsolidasi boleh hapus memori basi

🎬Alurnya