minirag-mcp
Rank #1,693io.github.sfrangulov/minirag-mcp
Local-first RAG MCP server: hybrid search over a folder of your own documents
minirag-mcp is a Model Context Protocol (MCP) server published by sfrangulov. It ranks #1,693 of 115,591 servers tracked on MCP Toplist, and its repository has 65 GitHub stars. minirag-mcp is listed across 2 registries — Official MCP and Glama, with 1 tracked version. It was first listed on Aug 7, 2026 and most recently updated on Aug 9, 2026.
Ranks ahead of 113,898 of 115,591 servers on MCP Toplist.
Use minirag-mcp
No credentials or required configuration declared — add it to your MCP client and go.
claude mcp add minirag-mcp -e "BASE_DIR=<your BASE_DIR>" -e "BASE_DIRS=<your BASE_DIRS>" -e "DB_PATH=<your DB_PATH>" -e "CACHE_DIR=<your CACHE_DIR>" -e "MODEL_NAME=<your MODEL_NAME>" -e "MAX_FILE_SIZE=<your MAX_FILE_SIZE>" -e "CHUNK_TOKEN_BUDGET=<your CHUNK_TOKEN_BUDGET>" -e "RAG_HYBRID_WEIGHT=<your RAG_HYBRID_WEIGHT>" -e "RAG_GROUPING=<your RAG_GROUPING>" -e "RAG_MAX_DISTANCE=<your RAG_MAX_DISTANCE>" -e "RAG_MAX_FILES=<your RAG_MAX_FILES>" -e "RAG_INSTRUCTIONS_APPEND=<your RAG_INSTRUCTIONS_APPEND>" -e "ALLOW_PRIVATE_URLS=<your ALLOW_PRIVATE_URLS>" -- uvx minirag-mcpReplace each placeholder with your own value before saving.
[mcp_servers.minirag-mcp]
command = "uvx"
args = ["minirag-mcp"]
[mcp_servers.minirag-mcp.env]
BASE_DIR = "<your BASE_DIR>"
BASE_DIRS = "<your BASE_DIRS>"
DB_PATH = "<your DB_PATH>"
CACHE_DIR = "<your CACHE_DIR>"
MODEL_NAME = "<your MODEL_NAME>"
MAX_FILE_SIZE = "<your MAX_FILE_SIZE>"
CHUNK_TOKEN_BUDGET = "<your CHUNK_TOKEN_BUDGET>"
RAG_HYBRID_WEIGHT = "<your RAG_HYBRID_WEIGHT>"
RAG_GROUPING = "<your RAG_GROUPING>"
RAG_MAX_DISTANCE = "<your RAG_MAX_DISTANCE>"
RAG_MAX_FILES = "<your RAG_MAX_FILES>"
RAG_INSTRUCTIONS_APPEND = "<your RAG_INSTRUCTIONS_APPEND>"
ALLOW_PRIVATE_URLS = "<your ALLOW_PRIVATE_URLS>"Add to ~/.codex/config.toml. Replace each placeholder with your own value before saving.
{
"mcpServers": {
"minirag-mcp": {
"command": "uvx",
"args": [
"minirag-mcp"
],
"env": {
"BASE_DIR": "<your BASE_DIR>",
"BASE_DIRS": "<your BASE_DIRS>",
"DB_PATH": "<your DB_PATH>",
"CACHE_DIR": "<your CACHE_DIR>",
"MODEL_NAME": "<your MODEL_NAME>",
"MAX_FILE_SIZE": "<your MAX_FILE_SIZE>",
"CHUNK_TOKEN_BUDGET": "<your CHUNK_TOKEN_BUDGET>",
"RAG_HYBRID_WEIGHT": "<your RAG_HYBRID_WEIGHT>",
"RAG_GROUPING": "<your RAG_GROUPING>",
"RAG_MAX_DISTANCE": "<your RAG_MAX_DISTANCE>",
"RAG_MAX_FILES": "<your RAG_MAX_FILES>",
"RAG_INSTRUCTIONS_APPEND": "<your RAG_INSTRUCTIONS_APPEND>",
"ALLOW_PRIVATE_URLS": "<your ALLOW_PRIVATE_URLS>"
}
}
}
}Add to claude_desktop_config.json (Settings → Developer → Edit Config). Replace each placeholder with your own value before saving.
{
"mcpServers": {
"minirag-mcp": {
"command": "uvx",
"args": [
"minirag-mcp"
],
"env": {
"BASE_DIR": "<your BASE_DIR>",
"BASE_DIRS": "<your BASE_DIRS>",
"DB_PATH": "<your DB_PATH>",
"CACHE_DIR": "<your CACHE_DIR>",
"MODEL_NAME": "<your MODEL_NAME>",
"MAX_FILE_SIZE": "<your MAX_FILE_SIZE>",
"CHUNK_TOKEN_BUDGET": "<your CHUNK_TOKEN_BUDGET>",
"RAG_HYBRID_WEIGHT": "<your RAG_HYBRID_WEIGHT>",
"RAG_GROUPING": "<your RAG_GROUPING>",
"RAG_MAX_DISTANCE": "<your RAG_MAX_DISTANCE>",
"RAG_MAX_FILES": "<your RAG_MAX_FILES>",
"RAG_INSTRUCTIONS_APPEND": "<your RAG_INSTRUCTIONS_APPEND>",
"ALLOW_PRIVATE_URLS": "<your ALLOW_PRIVATE_URLS>"
}
}
}
}Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (per project). Replace each placeholder with your own value before saving.
{
"servers": {
"minirag-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"minirag-mcp"
],
"env": {
"BASE_DIR": "<your BASE_DIR>",
"BASE_DIRS": "<your BASE_DIRS>",
"DB_PATH": "<your DB_PATH>",
"CACHE_DIR": "<your CACHE_DIR>",
"MODEL_NAME": "<your MODEL_NAME>",
"MAX_FILE_SIZE": "<your MAX_FILE_SIZE>",
"CHUNK_TOKEN_BUDGET": "<your CHUNK_TOKEN_BUDGET>",
"RAG_HYBRID_WEIGHT": "<your RAG_HYBRID_WEIGHT>",
"RAG_GROUPING": "<your RAG_GROUPING>",
"RAG_MAX_DISTANCE": "<your RAG_MAX_DISTANCE>",
"RAG_MAX_FILES": "<your RAG_MAX_FILES>",
"RAG_INSTRUCTIONS_APPEND": "<your RAG_INSTRUCTIONS_APPEND>",
"ALLOW_PRIVATE_URLS": "<your ALLOW_PRIVATE_URLS>"
}
}
}
}Save as .vscode/mcp.json in your workspace. Replace each placeholder with your own value before saving.
{
"mcpServers": {
"minirag-mcp": {
"command": "uvx",
"args": [
"minirag-mcp"
],
"env": {
"BASE_DIR": "<your BASE_DIR>",
"BASE_DIRS": "<your BASE_DIRS>",
"DB_PATH": "<your DB_PATH>",
"CACHE_DIR": "<your CACHE_DIR>",
"MODEL_NAME": "<your MODEL_NAME>",
"MAX_FILE_SIZE": "<your MAX_FILE_SIZE>",
"CHUNK_TOKEN_BUDGET": "<your CHUNK_TOKEN_BUDGET>",
"RAG_HYBRID_WEIGHT": "<your RAG_HYBRID_WEIGHT>",
"RAG_GROUPING": "<your RAG_GROUPING>",
"RAG_MAX_DISTANCE": "<your RAG_MAX_DISTANCE>",
"RAG_MAX_FILES": "<your RAG_MAX_FILES>",
"RAG_INSTRUCTIONS_APPEND": "<your RAG_INSTRUCTIONS_APPEND>",
"ALLOW_PRIVATE_URLS": "<your ALLOW_PRIVATE_URLS>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json. Replace each placeholder with your own value before saving.
{
"mcpServers": {
"minirag-mcp": {
"command": "uvx",
"args": [
"minirag-mcp"
],
"env": {
"BASE_DIR": "<your BASE_DIR>",
"BASE_DIRS": "<your BASE_DIRS>",
"DB_PATH": "<your DB_PATH>",
"CACHE_DIR": "<your CACHE_DIR>",
"MODEL_NAME": "<your MODEL_NAME>",
"MAX_FILE_SIZE": "<your MAX_FILE_SIZE>",
"CHUNK_TOKEN_BUDGET": "<your CHUNK_TOKEN_BUDGET>",
"RAG_HYBRID_WEIGHT": "<your RAG_HYBRID_WEIGHT>",
"RAG_GROUPING": "<your RAG_GROUPING>",
"RAG_MAX_DISTANCE": "<your RAG_MAX_DISTANCE>",
"RAG_MAX_FILES": "<your RAG_MAX_FILES>",
"RAG_INSTRUCTIONS_APPEND": "<your RAG_INSTRUCTIONS_APPEND>",
"ALLOW_PRIVATE_URLS": "<your ALLOW_PRIVATE_URLS>"
}
}
}
}Replace each placeholder with your own value before saving.
Show your rank
Maintain this server? Add the live rank badge to your README — it updates automatically as the leaderboard changes.
[](https://mcptoplist.com/server/io.github.sfrangulov%2Fminirag-mcp)<a href="https://mcptoplist.com/server/io.github.sfrangulov%2Fminirag-mcp"><img src="https://mcptoplist.com/badge/io.github.sfrangulov%2Fminirag-mcp.svg" alt="MCP Toplist: Top 5% of 115,591" /></a>Variants: append ?metric=score or ?metric=stars to the image URL.
Listed on 2 registries
sfrangulov
Other servers by sfrangulov
View all sfrangulov servers →Available versions (1)
| Version | Published |
|---|---|
| 0.4.1 | Aug 9, 2026 |
Frequently asked questions
- Who maintains minirag-mcp?
- minirag-mcp is maintained by sfrangulov, which publishes 2 MCP servers (1 total version) tracked on MCP Toplist.
- Is minirag-mcp listed on the Official MCP Registry?
- Yes — minirag-mcp is listed on the Official MCP Registry, alongside Glama.
- How many versions does minirag-mcp have?
- MCP Toplist tracks 1 version of minirag-mcp, most recently published on Aug 9, 2026.
- Where can I find the source code for minirag-mcp?
- The source code for minirag-mcp is hosted at github.com/sfrangulov/minirag-mcp.