mcp local rag for Gemini CLI

io.github.shinpr/mcp-local-rag

Easy-to-setup local RAG server with minimal configuration

client:Gemini CLI transport:stdio runtime:npm

Install mcp local rag in Gemini CLI

~/.gemini/settings.json · windows: %USERPROFILE%\.gemini\settings.json

BASE_DIR

BASE_DIRS

DB_PATH

CACHE_DIR

HF_ENDPOINT

MODEL_NAME

MAX_FILE_SIZE

RAG_MAX_DISTANCE

RAG_GROUPING

RAG_MAX_FILES

CHUNK_MIN_LENGTH

STORE_IMAGES

RAG_DEVICE

RAG_DTYPE

RAG_HYBRID_WEIGHT

RAG_RERANK_CMD

RAG_RERANK_TIMEOUT_MS

Held in this page only — never stored, logged, or sent anywhere but back to your screen.

{
  "mcpServers": {
    "mcp-local-rag": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-local-rag"
      ],
      "env": {
        "BASE_DIR": "<BASE_DIR>",
        "BASE_DIRS": "<BASE_DIRS>",
        "DB_PATH": "<DB_PATH>",
        "CACHE_DIR": "<CACHE_DIR>",
        "HF_ENDPOINT": "<HF_ENDPOINT>",
        "MODEL_NAME": "<MODEL_NAME>",
        "MAX_FILE_SIZE": "<MAX_FILE_SIZE>",
        "RAG_MAX_DISTANCE": "<RAG_MAX_DISTANCE>",
        "RAG_GROUPING": "<RAG_GROUPING>",
        "RAG_MAX_FILES": "<RAG_MAX_FILES>",
        "CHUNK_MIN_LENGTH": "<CHUNK_MIN_LENGTH>",
        "STORE_IMAGES": "<STORE_IMAGES>",
        "RAG_DEVICE": "<RAG_DEVICE>",
        "RAG_DTYPE": "<RAG_DTYPE>",
        "RAG_HYBRID_WEIGHT": "<RAG_HYBRID_WEIGHT>",
        "RAG_RERANK_CMD": "<RAG_RERANK_CMD>",
        "RAG_RERANK_TIMEOUT_MS": "<RAG_RERANK_TIMEOUT_MS>"
      }
    }
  }
}

Gemini expands $VAR and ${VAR} inside env values, so a secret can live in your shell rather than this file. Gemini CLI docs

mcp local rag in other clients

mcp local rag MCP server