Skip to content
MCP server

MiniRAG

Self-hosted RAG knowledge base with hybrid retrieval, cited answers and an MCP server

Install
Pricing
Open source
Platforms
self-hosted, CLI, Web
Runs
Remotely
Version
0.1.0
Listing updated
today

Similar MCP servers

About MiniRAG

MiniRAG is an open-source MCP server for knowledge and memory. It runs as a hosted remote server, so there is nothing to install locally.

Everything runs in one Spring Boot process with SQLite storage, so there is no vector database or message queue. Retrieval fuses in-memory cosine similarity with SQLite FTS5 BM25 using reciprocal rank fusion, with optional LLM reranking, and answers carry clickable citations showing only the sources actually cited. The README says it runs in about 250 MB of memory on a 1 GB VPS.

The MCP server uses SSE transport and exposes two tools: query asks a question and returns a cited answer, with an optional retrieval mode, and ingest_text adds a document using an admin key. A REST API, streaming web UI and WeChat Work callback sit alongside it. You supply your own chat endpoint, defaulting to DeepSeek, and an OpenAI-compatible embeddings endpoint, defaulting to SiliconFlow's BGE-M3.

The repository includes an evaluation harness; the README reports hybrid with rerank reaching 100 percent top-1 on its demo set and includes a 20-question labour-law evaluation. Run it with Docker or build with Java 21. It is MIT licensed, and the hosted demo needs credentials from the owner.

Install

Run in a terminal

claude mcp add --transport sse minirag https://minirag.kimelody.de5.net/sse

Add to Settings → Connectors → Add custom connector

https://minirag.kimelody.de5.net/sse
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "minirag": {
      "url": "https://minirag.kimelody.de5.net/sse"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "minirag": {
      "type": "sse",
      "url": "https://minirag.kimelody.de5.net/sse"
    }
  }
}

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

{
  "mcpServers": {
    "minirag": {
      "serverUrl": "https://minirag.kimelody.de5.net/sse"
    }
  }
}

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

{
  "mcpServers": {
    "minirag": {
      "type": "sse",
      "url": "https://minirag.kimelody.de5.net/sse"
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Tools this server provides (2)

Taken from the project documentation; the running server may differ.

query
Asks a question and returns a cited answer, with an optional retrieval mode.
ingest_text
Adds a document by id and text using an admin key.

What it does

Hybrid retrieval
Vector and BM25 results fused with RRF, plus optional rerank.
Cited answers
Clickable citations list only the sources used.
Single process
SQLite storage with no vector database or queue.
MCP tools
query for answers and ingest_text to add documents.
Evaluation harness
Labelled question sets with Top-1, Recall and MRR scoring.
Multiple interfaces
MCP over SSE, REST API, web UI and WeChat Work.

Good for

  • Stand up a private document Q&A on a small server
  • Give an assistant cited answers from internal notes
  • Ingest text documents through an API
  • Compare vector, hybrid and rerank retrieval on your own data

Pricing

Open source

MIT licensed; you pay your own model API costs

MiniRAG FAQ

What does it need?

Docker or Java 21, plus API keys for a chat model and an embeddings endpoint.

Which model does it use by default?

DeepSeek for chat and BAAI/bge-m3 embeddings via SiliconFlow, both configurable.

How do I add documents?

With the ingest_text MCP tool or the REST ingest endpoints, using an admin key.

How much memory does it use?

About 250 MB RSS according to the README.

Is MiniRAG free?

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

How do I add MiniRAG to Claude Code?

Run this command in your terminal: claude mcp add --transport sse minirag https://minirag.kimelody.de5.net/sse

What are the best alternatives to MiniRAG?

The closest alternatives to MiniRAG are Codebase Memory, XERJ, headroom, omniget and next-ai-draw-io.

Where this comes from

  • Description: written from the project's README.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers