Back to Home
shinpr icon

mcp-local-rag

Verified Safe

by shinpr

Overview

Local RAG server for developers enabling private, offline semantic search with keyword boosting on personal or project documents (PDF, DOCX, TXT, MD, HTML).

Installation

Run Command
npx -y mcp-local-rag

Environment Variables

  • DB_PATH
  • MODEL_NAME
  • CACHE_DIR
  • BASE_DIR
  • MAX_FILE_SIZE
  • RAG_MAX_DISTANCE
  • RAG_GROUPING
  • RAG_HYBRID_WEIGHT
  • NODE_ENV

Security Notes

The server demonstrates strong security practices for a local RAG solution. It explicitly prevents path traversal attacks (S-002) by validating file paths against a defined `BASE_DIR` and ensuring they are absolute. All processing is local (S-001), with the only external network communication being the initial (cached) download of the embedding model from HuggingFace. Sensitive data (document content, search queries) is confirmed not to be logged (S-003), and stack traces are suppressed in production environments (S-004). No hardcoded secrets were found. The use of `isEvalSupported: false` in the PDF parser is a good practice. Overall, the security measures are well-implemented and tested.

Similar Servers

Stats

Interest Score61
Security Score9
Cost ClassLow
Avg Tokens2500
Stars62
Forks18
Last Update2026-01-17

Tags

Local RAGSemantic SearchKeyword BoostPrivacyOfflineMCP Server