MiniRAG
概览
作者提供的说明（英文原文）
Lightweight self-hosted RAG knowledge base with hybrid retrieval and cited answers.
PopNx MCP 的三大支柱
这三项永远不会合并成一个分数：意见、测量和人气是不同的东西。
- 用户评价i暂无评价评价功能将在后续阶段与账户功能一起开放
- 我们的基础检查i3 项中通过 2 项依据公开信息检查；尚未扫描代码
- 使用情况i非常新★ –
它能帮你做什么
我们还没有为它写通俗的介绍。下面是我们从注册中心读取到的事实。
- 连接方式: 在云端运行
- 传输方式: SSE
- 分类: 搜索与 AI 记忆
- 你需要填写：Authorization
安装
选择你使用的 AI 应用，然后复制设置。
安装之前
- 基础检查：3 项中通过 2 项
- 在作者的服务器上运行：你向它提出的内容会经过他们的服务器。
- 需要你自己填写：
Authorization
标为机密的值是你账户的钥匙。千万不要分享给别人，也不要粘贴到聊天里。
你需要
- 在云端运行无需安装任何东西，通过互联网连接
你用的是哪个应用？
在上方选择你的应用。我们会记住它，下次按钮会显示“安装到 …”。
这个地址需要在请求的 header 中放入密钥，而添加连接器的菜单无法设置。请改用 Claude Code、Cursor 或 VS Code。
在终端中运行这条命令
claude mcp add --transport sse minirag https://minirag.kimelody.de5.net/sse --header 'Authorization: your-value'运行前请先填写空着的值。
或者自己复制设置
粘贴到项目中的 .cursor/mcp.json，或 ~/.cursor/mcp.json
{
"mcpServers": {
"minirag": {
"url": "https://minirag.kimelody.de5.net/sse",
"headers": {
"Authorization": "your-value"
}
}
}
}浏览器会先询问是否打开应用，然后应用会显示设置并请你确认。密钥的值会留空，由你自己填写。
或者自己复制设置
粘贴到项目中的 .vscode/mcp.json
{
"servers": {
"minirag": {
"type": "sse",
"url": "https://minirag.kimelody.de5.net/sse",
"headers": {
"Authorization": "your-value"
}
}
}
}浏览器会先询问是否打开应用，然后应用会显示设置并请你确认。密钥的值会留空，由你自己填写。
这个地址需要在请求的 header 中放入密钥，而添加连接器的菜单无法设置。请改用 Claude Code、Cursor 或 VS Code。
你的选择通过 Cookie 保存在这台设备上，无需账户。
需要你填写的值
Authorization机密 必填 HTTP headerHTTP Basic auth: 'Basic ' + base64('demo: '). Request the access key from the repo owner (see README).
这些设置是根据作者在注册中心的条目生成的。如果 README 的写法不同，请以 README 为准。
它能做什么
服务器要求先登录，才会列出它的工具。
基础检查i
我们检查的是任何人都能看到的信息；我们没有阅读代码。不适用的检查项不计入总数。 · 检查于 2026年11月8日
- ✓ 通过
作者与仓库一致
注册名称已通过 GitHub 账户 KiMelody 验证，该账户拥有此仓库
- … 尚未检查
仍在维护
我们还没有从 GitHub 读取这个仓库
- … 尚未检查
有许可证
我们还没有从 GitHub 读取这个仓库
- ✓ 通过
端点有响应
在 848 毫秒内响应（HTTP 401）
- ! 注意
使用 OAuth 登录
需要你自己复制粘贴密钥或令牌
- … 尚未检查
工具描述中没有隐藏指令
尚未检查；我们会在检查端点时读取工具列表
与“搜索与 AI 记忆”中的其他服务器比较i
- 星标数多于此分类中其他 5696 个服务器的 0%
- 发布到注册中心的时间比此分类中其他 5696 个服务器的 63% 更新
- 基础检查结果等于或优于此分类中其他 5696 个服务器的 39%
与注册中心里这个分类中所有活跃的服务器比较。只有当发布者拥有该仓库时，星标数才计入。
常见问题
MiniRAG 安全吗？
它在 3 项适用的基础检查中通过了 2 项。我们没有阅读代码。在添加密钥或令牌之前，请先看看这个服务器要求哪些权限，并使用只具备所需权限的密钥。
它需要哪些密钥或代码？
你需要填写：Authorization
它在我的电脑上运行还是在云端？
它在作者的云端运行。通过互联网连接，无需安装，但你发送的内容会经过作者的服务器。
它还在维护吗？
GitHub 仓库最后更新于–，最新版本（0.1.0）于24天前进入注册中心。
哪些应用可以使用它？
支持 MCP 的应用，例如 Claude Desktop、Claude Code、Cursor 和 VS Code。它通过 URL 连接，所以接受远程 MCP 服务器的应用也可以使用，例如开启开发者模式的 ChatGPT。
有什么可以替代它？
同一分类中有：Context7, Codebase Memory, Exa
替代选择
同一分类中其他作者的服务器，按星标数排序。
如何看卡片：↓ 每周下载量i★ GitHub 星标i三大支柱：评价 · 检查 · 使用情况i更新 = 最新版本发布到注册中心的时间i
Codebase Memory
Codebase knowledge graph for AI agents — 162 languages, sub-ms queries, 99% fewer tokens.
Exa
Connect AI agents to Exa for web search, content fetching, and multi-step research.
作者的 README
打开 README
按原文从作者的仓库复制。PopNx MCP 没有审查或背书其内容。HTML、图片和脚本已被移除。链接会离开本站。
MiniRAG
A self-hosted RAG knowledge base in a single Spring Boot process: SQLite storage, hybrid retrieval, cited answers, and a built-in MCP server. No vector database, no message queue.
Live demo (ask the owner for the access code) · Evaluation report
Features
- Hybrid retrieval — in-memory cosine + SQLite FTS5 (BM25), fused with RRF; optional LLM rerank
- Cited answers — clickable
[n]citations; only sources actually cited are displayed - Streaming web UI — SSE, typewriter rendering, markdown, retrieval-mode switcher (vector / hybrid / rerank)
- Small footprint — single process, ~250MB RSS, runs on a 1GB VPS
- Multiple interfaces — MCP server (SSE transport), REST API, web UI, WeChat Work callback integration
Quick start
docker run -d --name minirag -p 18090:18090 --memory 512m \-v $(pwd)/data:/app/data \ -e DEEPSEEK_API_KEY=sk-... \ -e EMBEDDING_API_KEY=sk-... \ ghcr.io/kimelody/minirag:latest
Open http://localhost:18090 and start asking. Data lives in ./data (SQLite, created automatically).
Configuration
| Env | Required | Default | Description |
|---|---|---|---|
DEEPSEEK_BASE_URL | no | https://api.deepseek.com | Any OpenAI-compatible chat endpoint |
DEEPSEEK_API_KEY | yes | — | Chat model API key |
EMBEDDING_BASE_URL | no | https://api.siliconflow.cn/v1 | OpenAI-compatible embeddings endpoint |
EMBEDDING_API_KEY | yes | — | Embeddings API key |
EMBEDDING_MODEL | no | BAAI/bge-m3 | Embedding model |
DEMO_KEY | no | — | Visitor access code for read APIs; unset = open (local dev) |
ADMIN_KEY | no | — | Admin key required for ingest APIs |
MCP
Listed on the official MCP Registry as io.github.KiMelody/minirag. Two tools: query(question, mode?) — ask and get a cited answer; ingest_text(docId, text, adminKey) — add a document.
claude mcp add --transport sse minirag http://localhost:18090/sse{"mcpServers": { "minirag": { "url": "http://localhost:18090/sse" } } }
The hosted demo endpoint requires basic auth: https://minirag.kimelody.de5.net/sse (ask the owner for credentials).
REST API
| Method | Path | Description | ||
|---|---|---|---|---|
| POST | /api/chat | Ask; returns answer + cited sources (JSON) | ||
| POST | /api/chat/stream | Same, streamed as SSE (meta / token / sources / done) | ||
| GET | /api/search?q=&mode= | Retrieval debug: vector \ | hybrid \ | rerank |
| POST | /api/documents/text | Ingest {docId, text} (requires X-Admin-Key) | ||
| POST | /api/documents | Ingest an uploaded file, multipart (requires X-Admin-Key) |
Evaluation
An eval harness ships in eval/: labeled question sets, Top-1 / Recall / MRR scoring over three retrieval modes — hybrid+rerank reaches Top-1 100% / MRR 1.0 on the demo set (report); a 20-question labor-law evaluation with corpus-cleaning scripts lives in eval/law/. Bring your own corpus; raw source texts are not redistributed.
Build from source
mvn packagejava -jar target/minirag-0.1.0-SNAPSHOT.jar
Requires Java 21. API keys can be put in a .env file in the working directory (git-ignored).
中文说明
单进程私有化 RAG 知识库：SQLite 存储 + 混合检索（向量 + BM25，RRF 融合，可选 LLM 重排），回答带可点击引用角标，自带网页演示、REST API 与 MCP server（SSE），内存占用约 250MB，1GB 小服务器可跑。在线演示（访问码联系作者）。
License
MIT