Home/Data & Retrieval/mcp-local-rag
mcp-local-rag logo

mcp-local-rag

shinpr/mcp-local-rag

Local-first RAG server for developers with semantic and keyword search capabilities.

GraphCanon updated Sep 20, 2026 · GitHub synced Sep 20, 2026

85views this month

400 stars74 forksLast push Sep 20, 2026 TypeScript MIT

Decision brief

mcp-local-rag is designed for developers who prioritize privacy and ease of setup when performing semantic and keyword searches on local codebases and technical documents through MCP or CLI integration.

Good fit when

  • When you need to perform both semantic and keyword-based search operations within a local, privacy-focused environment tailored specifically for handling codebases and technical documentation.
  • If your project requires minimal setup yet offers robust search capabilities using the MCP or CLI methods of interaction with RAG services.

Avoid when

  • When you do not require a privacy-first approach and are willing to rely on cloud-based solutions that might offer more extensive feature sets beyond just keyword and semantic searches.
  • If your use case involves scaling search capabilities across multiple remote databases or servers, as mcp-local-rag is best suited for local data only.

Observed Jul 17, 2026 · Source: enrich:decision_facts

Verify the decision

Adoption

Package downloads where a registry match exists. GitHub stars (400) are secondary evidence.

npm downloads (30d)
17,005·npm downloads API·Sep 20, 2026

Maintenance and security

Full trust report
Maintenance
Very active (0d since push)
As of Sep 20, 2026
Provenance
Not a fork · Personal account
As of Sep 20, 2026
Security (OSV)
No criticals
As of Aug 9, 2026

Public GitHub metadata and optional OSV scans. Signals, not a guarantee. Trust methodology.

Install

npm install mcp-local-rag
npm

How it fits your stack(1)

Typed graph edges - alternatives, integrations, successors, and dependencies. Ranked by relationship type, not raw GitHub stars.

Relationship graph

Optional deeper exploration of typed edges and category neighbours.

Similar tools

Same-category neighbours not already linked as typed edges.

Evidence and technical details

Sourced facts, taxonomy, compatibility claims, README excerpt, and machine-readable endpoints.

Overview

Provides a privacy-focused, easy-to-setup environment for semantic and keyword-based searches within codebases and technical documents. Supports integration through MCP or CLI.

Capability facts

CLI
CLI entrypoint

Source: package.json:bin|scripts · Sep 20, 2026

MCP server
Ships MCP server

Source: package.json:@modelcontextprotocol/* · Sep 20, 2026

Languages
typescript, javascript

Source: github.language+package.json · Sep 20, 2026

Categories

Compatibility

Sourced claims from the README excerpt - not unsourced marketing copy.

Node.js runtimeNode.js

Source: README excerpt (regex_v1, Sep 20, 2026)

- Node.js 22 or later
Source link
stdio transportstdio

Source: README excerpt (regex_v1, Sep 20, 2026)

mcp-local-rag uses the standard MCP protocol over a local stdio server, so it works with AI
Source link
Works with CursorCursor

Source: README excerpt (regex_v1, Sep 20, 2026)

**For Cursor:** Add to `~/.cursor/mcp.json`:
Source link

Tags

README

Requirements Node.js 22 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 to that directory. It is also the security boundary for file operations. Replace below with the directory's ab...

For agents

This page has a .md twin and JSON over the API.

Was this helpful?

Anonymous feedback helps us improve pages and translations.