minirag-mcp

minirag-mcp is a local MCP server: Local-first RAG MCP server: hybrid search over a folder of your own documents. Install it from pypi as minirag-mcp.

Claude CodeCodexAntigravity

commandprompt

Terminal

claude mcp add minirag-mcp -e BASE_DIR=... -e BASE_DIRS=... -e DB_PATH=... -e CACHE_DIR=... -e MODEL_NAME=... -e MAX_FILE_SIZE=... -e CHUNK_TOKEN_BUDGET=... -e RAG_HYBRID_WEIGHT=... -e RAG_GROUPING=... -e RAG_MAX_DISTANCE=... -e RAG_MAX_FILES=... -e RAG_INSTRUCTIONS_APPEND=... -e ALLOW_PRIVATE_URLS=... -- uvx minirag-mcp

Run in your project folder. Add --scope user to use it everywhere.

Add to claude_desktop_config.json or .cursor/mcp.json.

{
  "mcpServers": {
    "minirag-mcp": {
      "command": "uvx",
      "args": [
        "minirag-mcp"
      ],
      "env": {
        "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": "..."
      }
    }
  }
}

Fill in the environment variables with your own credentials.

• Runtime: Python with uv (runs with uvx).
• MCP client: Claude Code, Codex, Antigravity, Claude Desktop, Cursor or any other client that speaks MCP over stdio.
• Environment variables: 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