shinpr/mcp-local-rag
shinpr
TypeScript313updated 4mo ago
TypeScript313updated 4mo agoLocal-first RAG server for developers. Semantic + keyword search for code and technical docs. Works with MCP or CLI. Fully private, zero setup.
ClaudeCodexCursorMCP
agent-skillsdeveloper-toolshybrid-searchlocal-firstlocal-ragmcpmcp-serverprivacy-firstragsemantic-searchskillsvector-search
README
<p align="center">
<img src="assets/banner.jpg" alt="MCP Local RAG — Search below the surface." width="600" />
</p>
MCP Local RAG
Local RAG for developers via MCP or CLI. Semantic search with keyword boost for exact technical terms — fully private, zero setup.
Features
-
Semantic search with keyword boost Vector search first, then keyword matching boosts exact matches. Terms like
useEffect, error codes, and class names rank higher—not just semantically guessed. -
Smart semantic chunking Chunks documents by meaning, not character count. Uses embedding similarity to find natural topic boundaries—keeping related content together and splitting where topics change.
-
Quality-first result filtering Groups results by relevance gaps instead of arbitrary top-K cutoffs. Get fewer but more trustworthy chunks.
-
Runs entirely locally No API keys, no cloud, no data leaving your machine. Works fully offline after the first model download.
-
Zero-friction setup One
npxcommand. No Docker, no Python, no servers to manage. Use via MCP, CLI, or both. Optional Agent Skills help AI assistants form better queries and interpret results.
Quick Start
Set BASE_DIR to the folder you want to search (or BASE_DIRS for multiple roots — see Configuration). Documents must live under one of the configured roots.
Add t