minirag mcp for Claude Desktop

io.github.sfrangulov/minirag-mcp

Local-first RAG MCP server: hybrid search over a folder of your own documents

client:Claude Desktop transport:stdio runtime:pypi

Install minirag mcp in Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json · windows: %APPDATA%\Claude\claude_desktop_config.json

BASE_DIR

BASE_DIRS

DB_PATH

CACHE_DIR

MODEL_NAME

MAX_FILE_SIZE

CHUNK_TOKEN_BUDGET

RAG_HYBRID_WEIGHT

RAG_GROUPING

RAG_MAX_DISTANCE

RAG_MAX_FILES

RAG_INSTRUCTIONS_APPEND

ALLOW_PRIVATE_URLS

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

{
  "mcpServers": {
    "minirag-mcp": {
      "command": "uvx",
      "args": [
        "minirag-mcp"
      ],
      "env": {
        "BASE_DIR": "<BASE_DIR>",
        "BASE_DIRS": "<BASE_DIRS>",
        "DB_PATH": "<DB_PATH>",
        "CACHE_DIR": "<CACHE_DIR>",
        "MODEL_NAME": "<MODEL_NAME>",
        "MAX_FILE_SIZE": "<MAX_FILE_SIZE>",
        "CHUNK_TOKEN_BUDGET": "<CHUNK_TOKEN_BUDGET>",
        "RAG_HYBRID_WEIGHT": "<RAG_HYBRID_WEIGHT>",
        "RAG_GROUPING": "<RAG_GROUPING>",
        "RAG_MAX_DISTANCE": "<RAG_MAX_DISTANCE>",
        "RAG_MAX_FILES": "<RAG_MAX_FILES>",
        "RAG_INSTRUCTIONS_APPEND": "<RAG_INSTRUCTIONS_APPEND>",
        "ALLOW_PRIVATE_URLS": "<ALLOW_PRIVATE_URLS>"
      }
    }
  }
}

Settings → Developer → Edit Config opens this file. Restart the app after saving. Claude Desktop docs

minirag mcp in other clients

minirag mcp MCP server