Skip to content
Windsurf

mcp local rag for Windsurf

io.github.shinpr/mcp-local-rag

Easy-to-setup local RAG server with minimal configuration

client:Windsurf transport:stdio runtime:npm

Install mcp local rag in Windsurf

~/.codeium/windsurf/mcp_config.json · windows: %USERPROFILE%\.codeium\windsurf\mcp_config.json

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>"
      }
    }
  }
}

Global only — Windsurf has no per-project MCP config. Refresh Cascade after saving. Windsurf docs

mcp local rag in other clients