MCP Local RAG
● Activeio.github.shinpr/mcp-local-rag
Easy-to-setup local RAG server with minimal configuration
Connect this server
One click to install, or copy the config below. Suits: Claude Desktop · Cursor.
Or add it manually — claude_desktop_config.json (Claude Desktop) or .cursor/mcp.json (Cursor):
{
"mcpServers": {
"mcp-local-rag": {
"command": "npx",
"args": [
"-y",
"mcp-local-rag@0.23.3"
]
}
}
}claude mcp add mcp-local-rag -- npx -y mcp-local-rag@0.23.3codex mcp add mcp-local-rag -- npx -y mcp-local-rag@0.23.3code --add-mcp '{"name":"mcp-local-rag","type":"stdio","command":"npx","args":["-y","mcp-local-rag@0.23.3"]}'Syntax from each client's docs (Claude Code: claude mcp add; Codex: codex mcp add; VS Code: code --add-mcp). Placeholders in angle brackets are values you fill in.
A starting point — check the repository for exact arguments and setup. Restart your client after editing the config.
- Category
- AI & Agents
- Version
- 0.23.3
- Registry
- active
- Published
- 11/11/2026
Is it safe? Is it maintained?
Serverdex check: Nov 17, 2026Looks healthy: MCP Local RAG is maintained, open source.
- Maintained
- Active
- Last commit 9 days ago (Nov 13, 2026), 1 open issues.
- Official registry
- Active
- Published as io.github.shinpr/mcp-local-rag in the official MCP registry, version 0.23.3.
- Source
- Open source, MIT
- Public repository under the MIT licence, 434 stars, 83 forks.
- Runs
- On your machine
- A local npm package started by your client; it can reach whatever your user account can.
- Credentials
- None declared
- The registry entry declares no required environment variables.
- Owner
- Unclaimed
- Nobody has claimed this page yet; the data above comes from the registry, GitHub and the live check.
Facts only: last commit and licence from GitHub, the entry's status from the official registry, credentials from the live check. Not a code audit — run the security scan on the endpoint yourself.
On GitHub
read Nov 17, 2026- Stars
- 434
- Forks
- 83
- Last push
- Nov 13, 2026
- License
- MIT
TypeScriptagent-skillscli-tooldeveloper-toolshybrid-searchlocal-firstlocal-ragmcpmcp-servermodel-context-protocolprivacy-firstragsemantic-searchvector-search
From the README
MCP Local RAG English | 简体中文 | Deutsch | Español | Português (Brasil) | Français Search private documents from an MCP client or the terminal without sending them to an embedding API. mcp-local-rag indexes PDF, DOCX, Markdown, and text files on your machine. Search combines semantic similarity with keyword matching, so queries can match both intent and exact technical terms such as API names, class names, and error codes. Results include source passages and, where available, headings, line numbers, or page numbers so you can check and cite the original document. No API key, Docker, Python, or external database is required. After the initial model download, text ingestion and search work offline. Quick Start Requirements • Node.js 22.20 or later • Internet access on first use to download the npm package and embedding model • A directory containing the documents you want to search Set BASE_DIR to that directory. It is also the security boundary for file operations. Replace /absolute/path/to/your/documents below with the directory's absolute path. Use one of the examples below, or register npx -y mcp-local-rag and set BASE_DIR using your client's MCP configuration format. Set DBPATH and CACHEDIR to absolute paths as well.…
Read the full README on GitHub →Alternatives to MCP Local RAG
All MCP Local RAG alternatives →Best AI & Agents servers →The most-starred AI & Agents servers in the index, with their live-check result.
| Server | Stars | Last push | Live check |
|---|---|---|---|
| Ruflo | 81,994 | Nov 2026 | Local / not checked |
| Claude Flow | 81,985 | Nov 2026 | Local / not checked |
| CodeBurn | 11,880 | Nov 2026 | Local / not checked |
| Kaneo | 9,825 | Nov 2026 | Local / not checked |
| Ha MCP | 7,958 | Nov 2026 | Local / not checked |
MCP Local RAG: questions people ask
- Is MCP Local RAG a remote or a local MCP server?
- According to its entry in the official MCP registry, MCP Local RAG ships as a local package (npm) that your client starts on your machine.
- Is MCP Local RAG safe to use?
- Looks healthy: MCP Local RAG is maintained, open source. In detail — maintained: Active; official registry: Active; source: Open source, MIT; runs: On your machine; credentials: None declared. Serverdex check of Nov 17, 2026. This is a reading of the repository, the registry entry and the live check, not a code audit; run the Serverdex security scan on the endpoint before trusting it with real data.
- Is MCP Local RAG still maintained?
- Active: the repository's last commit 9 days ago. Last push Nov 13, 2026, 434 GitHub stars, MIT licence. Read from GitHub on Nov 17, 2026.
- How do I add MCP Local RAG to Claude, Cursor or VS Code?
- Copy the config in "Connect this server" into your client's MCP config file (claude_desktop_config.json, ~/.cursor/mcp.json or .vscode/mcp.json), or use the one-click Add to Cursor / Add to VS Code buttons and the one-line commands for Claude Code and Codex; then restart the client.
More from shinpr
All 2 servers by shinpr →More AI & Agents servers
Browse all AI & Agents →SMRITI Memory
smriti-memcore
Neuro-inspired long-term memory for AI agents with semantic graph and consolidation.
Jsonaut
shoggi211
Repair malformed JSON from LLM/agent output; optional JSON Schema coercion. Free + x402 paid.
Tokenmizer
Shweta-Mishra-ai
Graph-backed session memory for LLMs: checkpoint, resume, file analysis, token-savings stats.
HexWitness
siaginw
Durable, build-scoped reverse-engineering evidence memory and query tools for AI agents.
BotArmor: LLM red teaming for chatbots
sidorenkav-collab
LLM red teaming and prompt injection testing for chatbots and AI agents: A-F grade, prompt fixes.
Heropedia
SiliconRoshiBill
Consult 324+ expert personas (Buffett, Jobs, Munger, Torvalds, ...) via 4 read-only registry tools.
Add the badge to your site
Show visitors that MCP Local RAG is listed here — it’s also the link we check for a free listing.
HTML — for your website
<a href="https://serverdex.io/server/io-github-shinpr-mcp-local-rag?utm_source=badge"><img src="https://serverdex.io/brand/badge.svg" alt="MCP Local RAG — listed on Serverdex" width="123" height="40" loading="lazy"></a>Recommended. A dofollow link from your own domain is the one that counts for search engines, and it's the link we check for a free listing.
Markdown — for your README
[](https://serverdex.io/server/io-github-shinpr-mcp-local-rag?utm_source=badge)Nice for visibility, but GitHub marks README links nofollow, so it doesn't pass authority. Use the HTML badge on your site as well.
Install buttons — for your README
[](https://serverdex.io/install/cursor/io-github-shinpr-mcp-local-rag) [](https://serverdex.io/install/vscode/io-github-shinpr-mcp-local-rag) [](https://serverdex.io/install/claude-code/io-github-shinpr-mcp-local-rag)One click opens Cursor or VS Code with this server's config prefilled; the Claude Code button lands on the one-line command. The links point at Serverdex, so when your config changes the buttons keep working.
Install buttons — HTML for your docs
<a href="https://serverdex.io/install/cursor/io-github-shinpr-mcp-local-rag"><img src="https://serverdex.io/brand/install-cursor.svg" alt="Add to Cursor — via Serverdex" width="140" height="28"></a>
<a href="https://serverdex.io/install/vscode/io-github-shinpr-mcp-local-rag"><img src="https://serverdex.io/brand/install-vscode.svg" alt="Add to VS Code — via Serverdex" width="147" height="28"></a>
<a href="https://serverdex.io/install/claude-code/io-github-shinpr-mcp-local-rag"><img src="https://serverdex.io/brand/install-claude-code.svg" alt="Open in Claude Code — via Serverdex" width="180" height="28"></a>Same buttons as plain links for a docs page or website.
Prefer a live badge with the score, stars and live check? Score badge (links to a page that explains the number and back to this listing).