SERVER
MCP Local Rag
Rank #228io.github.shinpr/mcp-local-rag
Easy-to-setup local RAG server with minimal configuration
First listed
Oct 31, 2025
Last publish date
Aug 29, 2026
OVERVIEW
MCP Local Rag is a Model Context Protocol (MCP) server published by shinpr. It ranks #228 of 115,591 servers tracked on MCP Toplist, and its repository has 379 GitHub stars. MCP Local Rag is listed across 4 registries — Official MCP, Smithery, PulseMCP and Glama, with 44 tracked versions. It was first listed on Oct 31, 2025 and most recently updated on Aug 29, 2026.
STANDING
#228of 115,591 tracked serversTop 0.5%
Ranks ahead of 115,363 of 115,591 servers on MCP Toplist.
Recent momentum
+135GitHub stars since Apr 27 (+55%)
CONNECT
Use MCP Local Rag
No setupRuns out of the box
No credentials or required configuration declared — add it to your MCP client and go.
npm package
claude mcp add mcp-local-rag -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 "RAG_MAX_DISTANCE=<your RAG_MAX_DISTANCE>" -e "RAG_GROUPING=<your RAG_GROUPING>" -e "RAG_MAX_FILES=<your RAG_MAX_FILES>" -e "CHUNK_MIN_LENGTH=<your CHUNK_MIN_LENGTH>" -e "STORE_IMAGES=<your STORE_IMAGES>" -e "RAG_DEVICE=<your RAG_DEVICE>" -e "RAG_DTYPE=<your RAG_DTYPE>" -e "RAG_HYBRID_WEIGHT=<your RAG_HYBRID_WEIGHT>" -- npx -y mcp-local-ragReplace each placeholder with your own value before saving.
npm package
[mcp_servers.mcp-local-rag]
command = "npx"
args = ["-y", "mcp-local-rag"]
[mcp_servers.mcp-local-rag.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>"
RAG_MAX_DISTANCE = "<your RAG_MAX_DISTANCE>"
RAG_GROUPING = "<your RAG_GROUPING>"
RAG_MAX_FILES = "<your RAG_MAX_FILES>"
CHUNK_MIN_LENGTH = "<your CHUNK_MIN_LENGTH>"
STORE_IMAGES = "<your STORE_IMAGES>"
RAG_DEVICE = "<your RAG_DEVICE>"
RAG_DTYPE = "<your RAG_DTYPE>"
RAG_HYBRID_WEIGHT = "<your RAG_HYBRID_WEIGHT>"Add to ~/.codex/config.toml. Replace each placeholder with your own value before saving.
npm package
{
"mcpServers": {
"mcp-local-rag": {
"command": "npx",
"args": [
"-y",
"mcp-local-rag"
],
"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>",
"RAG_MAX_DISTANCE": "<your RAG_MAX_DISTANCE>",
"RAG_GROUPING": "<your RAG_GROUPING>",
"RAG_MAX_FILES": "<your RAG_MAX_FILES>",
"CHUNK_MIN_LENGTH": "<your CHUNK_MIN_LENGTH>",
"STORE_IMAGES": "<your STORE_IMAGES>",
"RAG_DEVICE": "<your RAG_DEVICE>",
"RAG_DTYPE": "<your RAG_DTYPE>",
"RAG_HYBRID_WEIGHT": "<your RAG_HYBRID_WEIGHT>"
}
}
}
}Add to claude_desktop_config.json (Settings → Developer → Edit Config). Replace each placeholder with your own value before saving.
npm package
{
"mcpServers": {
"mcp-local-rag": {
"command": "npx",
"args": [
"-y",
"mcp-local-rag"
],
"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>",
"RAG_MAX_DISTANCE": "<your RAG_MAX_DISTANCE>",
"RAG_GROUPING": "<your RAG_GROUPING>",
"RAG_MAX_FILES": "<your RAG_MAX_FILES>",
"CHUNK_MIN_LENGTH": "<your CHUNK_MIN_LENGTH>",
"STORE_IMAGES": "<your STORE_IMAGES>",
"RAG_DEVICE": "<your RAG_DEVICE>",
"RAG_DTYPE": "<your RAG_DTYPE>",
"RAG_HYBRID_WEIGHT": "<your RAG_HYBRID_WEIGHT>"
}
}
}
}Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (per project). Replace each placeholder with your own value before saving.
npm package
{
"servers": {
"mcp-local-rag": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"mcp-local-rag"
],
"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>",
"RAG_MAX_DISTANCE": "<your RAG_MAX_DISTANCE>",
"RAG_GROUPING": "<your RAG_GROUPING>",
"RAG_MAX_FILES": "<your RAG_MAX_FILES>",
"CHUNK_MIN_LENGTH": "<your CHUNK_MIN_LENGTH>",
"STORE_IMAGES": "<your STORE_IMAGES>",
"RAG_DEVICE": "<your RAG_DEVICE>",
"RAG_DTYPE": "<your RAG_DTYPE>",
"RAG_HYBRID_WEIGHT": "<your RAG_HYBRID_WEIGHT>"
}
}
}
}Save as .vscode/mcp.json in your workspace. Replace each placeholder with your own value before saving.
npm package
{
"mcpServers": {
"mcp-local-rag": {
"command": "npx",
"args": [
"-y",
"mcp-local-rag"
],
"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>",
"RAG_MAX_DISTANCE": "<your RAG_MAX_DISTANCE>",
"RAG_GROUPING": "<your RAG_GROUPING>",
"RAG_MAX_FILES": "<your RAG_MAX_FILES>",
"CHUNK_MIN_LENGTH": "<your CHUNK_MIN_LENGTH>",
"STORE_IMAGES": "<your STORE_IMAGES>",
"RAG_DEVICE": "<your RAG_DEVICE>",
"RAG_DTYPE": "<your RAG_DTYPE>",
"RAG_HYBRID_WEIGHT": "<your RAG_HYBRID_WEIGHT>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json. Replace each placeholder with your own value before saving.
npm package
{
"mcpServers": {
"mcp-local-rag": {
"command": "npx",
"args": [
"-y",
"mcp-local-rag"
],
"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>",
"RAG_MAX_DISTANCE": "<your RAG_MAX_DISTANCE>",
"RAG_GROUPING": "<your RAG_GROUPING>",
"RAG_MAX_FILES": "<your RAG_MAX_FILES>",
"CHUNK_MIN_LENGTH": "<your CHUNK_MIN_LENGTH>",
"STORE_IMAGES": "<your STORE_IMAGES>",
"RAG_DEVICE": "<your RAG_DEVICE>",
"RAG_DTYPE": "<your RAG_DTYPE>",
"RAG_HYBRID_WEIGHT": "<your RAG_HYBRID_WEIGHT>"
}
}
}
}Replace each placeholder with your own value before saving.
BADGE
Show your rank
Maintain this server? Add the live rank badge to your README — it updates automatically as the leaderboard changes.
Markdown
[](https://mcptoplist.com/server/io.github.shinpr%2Fmcp-local-rag)HTML
<a href="https://mcptoplist.com/server/io.github.shinpr%2Fmcp-local-rag"><img src="https://mcptoplist.com/badge/io.github.shinpr%2Fmcp-local-rag.svg" alt="MCP Toplist: Top 1% of 115,591" /></a>Variants: append ?metric=score or ?metric=stars to the image URL.
REGISTRIES
Listed on 1 registry (3 delisted)
ORGANIZATION
shinpr
MORE FROM THIS PUBLISHER
Other servers by shinpr
View all shinpr servers →VERSIONS
Available versions (44)
| Version | Published |
|---|---|
| 0.18.1 | Aug 29, 2026 |
| 0.18.0 | Aug 23, 2026 |
| 0.17.4 | Aug 12, 2026 |
| 0.17.3 | Aug 3, 2026 |
| 0.17.2 | Jul 29, 2026 |
| 0.17.1 | Jul 28, 2026 |
| 0.17.0 | Jul 27, 2026 |
| 0.15.4 | Jul 4, 2026 |
| 0.15.1 | Jun 12, 2026 |
| 0.14.2 | May 23, 2026 |
| 0.14.1 | May 17, 2026 |
| 0.14.0 | May 17, 2026 |
| 0.13.2 | May 11, 2026 |
| 0.13.1 | May 7, 2026 |
| 0.13.0 | Apr 17, 2026 |
| 0.12.0 | Apr 2, 2026 |
| 0.11.1 | Mar 30, 2026 |
| 0.11.0 | Mar 30, 2026 |
| 0.10.1 | Mar 29, 2026 |
| 0.10.0 | Mar 19, 2026 |
| 0.9.0 | Mar 18, 2026 |
| 0.8.1 | Mar 17, 2026 |
| 0.8.0 | Mar 7, 2026 |
| 0.7.0 | Feb 24, 2026 |
| 0.6.0 | Feb 22, 2026 |
| 0.5.6 | Feb 20, 2026 |
| 0.5.5 | Feb 4, 2026 |
| 0.5.4 | Jan 24, 2026 |
| 0.5.3 | Jan 8, 2026 |
| 0.5.2 | Jan 6, 2026 |
| 0.5.1 | Jan 1, 2026 |
| 0.5.0 | Jan 1, 2026 |
| 0.4.2 | Dec 29, 2025 |
| 0.4.1 | Dec 27, 2025 |
| 0.4.0 | Dec 27, 2025 |
| 0.3.0 | Dec 24, 2025 |
| 0.2.3 | Dec 5, 2025 |
| 0.2.2 | Dec 2, 2025 |
| 0.2.0 | Nov 3, 2025 |
| 0.1.5 | Nov 2, 2025 |
| 0.1.4 | Nov 2, 2025 |
| 0.1.3 | Oct 31, 2025 |
| 0.1.1 | Oct 31, 2025 |
| 0.1.0 | Nov 25, 2024 |
FAQ
Frequently asked questions
- Who maintains MCP Local Rag?
- MCP Local Rag is maintained by shinpr, which publishes 3 MCP servers (92 total versions) tracked on MCP Toplist.
- Is MCP Local Rag listed on the Official MCP Registry?
- Yes — MCP Local Rag is listed on the Official MCP Registry, alongside Smithery, PulseMCP and Glama.
- How many versions does MCP Local Rag have?
- MCP Toplist tracks 44 versions of MCP Local Rag, most recently published on Aug 29, 2026.
- Where can I find the source code for MCP Local Rag?
- The source code for MCP Local Rag is hosted at github.com/shinpr/mcp-local-rag.
EXPLORE