shinpr/mcp-local-rag

Overview

Local-first RAG server for developers. Performs semantic and keyword search over code and technical documents. Runs as an MCP server or CLI tool with zero setup and full data privacy.

Best for

Best for
Developers who need private, local search over code and docs without external dependencies.

Use cases

• Search codebases locally without sending data to the cloud
• Query technical documentation using natural language
• Integrate RAG capabilities into MCP-compatible development tools

How to use

Install

npx mcp-local-rag ingest ./docs/

Tools exposed

• sync_start
• sync_status
• ingest_file
• ingest_data
• query_documents
• read_chunk_neighbors
• list_files
• delete_file
• RAG_HYBRID_WEIGHT
• RAG_GROUPING
• RAG_MAX_DISTANCE
• RAG_MAX_FILES
• BASE_DIR
• BASE_DIRS
• DB_PATH
• CACHE_DIR
• MODEL_NAME
• MAX_FILE_SIZE
• CHUNK_MIN_LENGTH
• STORE_IMAGES

Tested with

Claude Code, Cursor

Example client config

{\n  "mcpServers": {\n    "local-rag": {\n      "command": "npx",\n      "args": ["-y", "mcp-local-rag"],\n      "env": {\n        "BASE_DIR": "/path/to/your/documents"\n      }\n    }\n  }\n}

Notes

Local-first RAG server for developers. Performs semantic and keyword search over code and technical documents. Runs as an MCP server or CLI tool with zero setup and full data privacy.

290 stars on GitHub. Last updated 2026-05-23. Licensed MIT.

Use cases

• Search codebases locally without sending data to the cloud
• Query technical documentation using natural language
• Integrate RAG capabilities into MCP-compatible development tools

Pros

• Fully private, no data leaves the machine
• Zero setup, works out of the box
• Supports both MCP and CLI interfaces

Cons

• Limited to local resources, may not handle very large datasets efficiently
• Small community with 290 stars, fewer integrations and extensions
• Relies on local compute, can be slower than cloud alternatives for complex queries

Indexed from awesome-mcp-servers-punkpeye and enriched against its public facts.