Skip to content
MCP server

Rag Vault

Local RAG MCP server with hybrid search, PDF/DOCX support, and zero-config setup

Runs locallyStatus and history
Install
Pricing
Open source
Runs
Locally
Version
1.5.3
Listing updated
4 days ago

About Rag Vault

Rag Vault is an open-source MCP server for knowledge and memory. It runs locally on your machine and is started by your AI client.

Install

Run in a terminal

claude mcp add rag-vault -- npx -y @robthepcguy/rag-vault

Add to claude_desktop_config.json

{
  "mcpServers": {
    "rag-vault": {
      "command": "npx",
      "args": [
        "-y",
        "@robthepcguy/rag-vault"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "rag-vault": {
      "command": "npx",
      "args": [
        "-y",
        "@robthepcguy/rag-vault"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "rag-vault": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@robthepcguy/rag-vault"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "rag-vault": {
      "command": "npx",
      "args": [
        "-y",
        "@robthepcguy/rag-vault"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "rag-vault": {
      "command": "npx",
      "args": [
        "-y",
        "@robthepcguy/rag-vault"
      ]
    }
  }
}

Configuration

  • BASE_DIRBase directory for document storage (defaults to current working directory)
  • DB_PATHPath to LanceDB database directory (defaults to ./lancedb/)
  • CACHE_DIRDirectory where Transformers.js models are cached (defaults to ./models/)
  • MODEL_NAMEEmbedding model name (defaults to Xenova/all-MiniLM-L6-v2)
  • RAG_HYBRID_WEIGHTKeyword boost strength for hybrid search. 0.0 = semantic only, 1.0 = keyword only. Default 0.6
  • RAG_GROUPINGGrouping mode: 'similar' (top group only) or 'related' (top 2 groups)

Pricing

Open source

Rag Vault FAQ

Is Rag Vault free?

Yes. Rag Vault is open source, so you can use and self-host it for free.

How do I add Rag Vault to Claude Code?

Run this command in your terminal: claude mcp add rag-vault -- npx -y @robthepcguy/rag-vault

What are the best alternatives to Rag Vault?

The closest alternatives to Rag Vault are Codebase Memory, XERJ, Claude Code Ultimate Guide, Nautilus Compass Memory and note1.

Alternatives to Rag Vault

  1. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  2. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  3. MCP server for searching the Claude Code Ultimate Guide from any MCP client

    Runs locally
    • Open source
    • 6.5K GitHub stars
    • AI models and LLM tooling
  4. Local-first long-term memory layer for AI agents, served over MCP

    Not checked yet
    • 5 tools
    • Remote
    • Open source
    • 1.3K GitHub stars
    • Knowledge and memory
  5. note1

    MCP server

    MCP server giving AI assistants search and summaries across your note1 meetings

    • 4 tools
    • Remote
    • Free trial
    • 1 GitHub star
    • Productivity
  6. ASTra

    MCP server

    Let agents read, edit, validate and undo Word .docx files with exact operations

    Runs locally
    • 5 tools
    • Freemium
    • Files and documents