🚀 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

18 Tools

Bisa offline

🦸Siapa bosnya?

The Coder — "I'm The Coder, Selamat datang dan Semoga perjalanan mu menyenangkan"

Disimpan sebagai memori importance-1.0, tag identity — tiap sesi menyapa The Coder lebih dulu 👋

✨Fungsi utama

🧠

Memori Konteks

Ingat fakta, keputusan, preferensi. Panggil lagi kapan saja. Rating pentingnya, satukan yang dobel!

📚

RAG Dokumen

Kasih dokumen → dipecah & di-embed & disimpan di SQLite → tanya apa saja, dapat bagian yang tepat.

⚡

Tanpa API

Embedder hash lokal 1024-dim, node:sqlite bawaan. Tanpa cloud, tanpa key, tanpa tagihan 💸

🔎

Cari Hybrid

BM25 (FTS5) + vektor digabung pakai RRF. Presisi kata kunci, paham makna — dua-duanya!

🔌

MCP Universal

Mendukung opencode, Claude Desktop, Cursor, VS Code — satu memori untuk semua teman MCP.

🛡️

Input Aman

File gede ditolak (RAG_MAX_FILE_MB), path bisa di-batasi (RAG_ALLOWED_DIRS), dokumen dobel dideteksi.

⚡Mulai cepat

3 perintah mudah, langsung jalan! 🎩

npm install
npm test                 # 92 cek: unit + round-trip MCP
npm run build            # kompilasi ke dist/
npm run cli -- stats     # playground CLI
npx mcp-rag-memory       # langsung jalan dari npm

🌍Satu memori, semua agent

⚡

opencode

Config MCP global — ingat kamu di semua project.

🟣

Claude Desktop

claude_desktop_config.json → mcpServers.

🔵

Cursor / Windsurf

Settings → MCP → Add server. Trik yang sama jalan!

🟦

VS Code

.vscode/mcp.json dengan "type": "stdio".

🧩 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!

🧰18 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 Cari	`rag_retrieve`	Blok konteks siap-suntik
RAG Dokumen	`rag_list_documents`	Inventaris dokumen
RAG Dokumen	`rag_delete_document`	Hapus dokumen + chunk
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

🏗️Arsitektur

database.ts

node:sqlite — dok, chunk, memori, chunks_fts, meta

embedder.ts

Hash lokal 1024-dim (FNV-1a + n-gram)

embeddings.ts

Lapisan provider: local | transformers (opsional)

chunker.ts

Chunking sadar paragraf/kode + overlap

vector-search.ts

Cache vektor + FTS5 BM25 + gabung RRF

pipeline.ts

Ingest async / dedup / guard / kelola dok

memory.ts

Remember / recall (decay) / consolidate / prune

rag-server.ts

Server MCP — 18 tools, transport stdio

🍪 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

Simpan

rag_ingest_*
memory_remember

Panggil

memory_context
rag_retrieve

Eksekusi

Suntik konteks → biar AI kamu makin cemerlang ✨