MiniRAG
Self-hosted RAG knowledge base with hybrid retrieval, cited answers and an MCP server
- 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/sseAdd to Settings → Connectors → Add custom connector
https://minirag.kimelody.de5.net/sseAdd to ~/.cursor/mcp.json
{
"mcpServers": {
"minirag": {
"url": "https://minirag.kimelody.de5.net/sse"
}
}
}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.



