Local RAG (shinpr) MCP Server

Search private documents from an MCP client or the terminal without sending them to an embedding API. It runs locally over stdio via the published package.

People who work with local rag, privacy first and semantic search and want it reachable from Claude, Cursor, VS Code, or another MCP client. The project is written in TypeScript.

VERIFIED ACTIVE

LAST COMMIT 2026-09-18 · ★ 398 · #2 OF 106 MAINTAINED AI & ML · VERIFIED 2026-09-18

MIT · TypeScript servers · how we verify → /methodology

01 · Install Local RAG (shinpr)

before you install - you'll need

Set BASE_DIR, RAG_HYBRID_WEIGHT, BASE_DIRS before connecting.

Claude Code

claude mcp add shinpr-mcp-local-rag -- npx -y mcp-local-rag

Claude Desktop / Cursor / VS Code - add to config

{
  "mcpServers": {
    "shinpr-mcp-local-rag": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-local-rag"
      ]
    }
  }
}

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions

license MIT - declared in the repository

npm package mcp-local-rag - unscoped; check the name against the project README before installing

registry namespace io.github.shinpr is GitHub-verified and matches the repo owner

03 · What Local RAG (shinpr) can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

Latest releases

v0.18.6 · 2026-09-18

Changes · ingest no longer fails on CJK and other dense-script documents. Text that exceeds the embedding model's token limit is now split instead of truncated, so the end of a long paragraph stays searchable. Content…

v0.18.5 · 2026-09-15

Changes · Added HF_ENDPOINT support for downloading embedding and visual models from a Hugging Face mirror. · Contributors · Thanks to @pecastro for adding Hugging Face mirror support (#200).

v0.18.4 · 2026-09-07

The quality visual profile now runs Qwen3.5-2B instead of Qwen2.5-VL-3B. It reads in-image text · (axis labels, panel sub-labels, table headers) far more reliably, and the model cache drops from · about 2.9 GB to about…

04 · Who maintains Local RAG (shinpr)

mcp-local-rag is maintained by shinpr. We track 3 MCP servers from shinpr - 3 actively maintained, 662 combined GitHub stars, oldest repo from Aug 2025. Full record: all servers from shinpr.

  1. mcp-image AI image generation and editing with prompt optimization and quality presets ★ 166
  2. sub-agents-mcp MCP server for delegating tasks to specialized AI sub-agents across coding tools ★ 98

05 · Facts

repository
github.com/shinpr/mcp-local-rag
category
AI & ML - ranked #2 of 106 actively-maintained AI & ML servers as of 2026-09-18.
release cadence
10+ releases in the last 90 days (latest 2026-09-18)
registry
io.github.shinpr/mcp-local-rag (active, first published 2025-10-31 · 52 versions)
packages
npm:mcp-local-rag

06 · Local RAG (shinpr) FAQ

What is Local RAG (shinpr)?

Search private documents from an MCP client or the terminal without sending them to an embedding API. It runs locally over stdio via the published package.

Is Local RAG (shinpr) still maintained?

Yes - as of 2026-09-18, its last commit was 2026-09-18 and it shipped 10+ releases in the last 90 days. We re-verify nightly.

How do I install Local RAG (shinpr)?

Run `npx -y mcp-local-rag`. The README documents 3 environment variables (BASE_DIR, RAG_HYBRID_WEIGHT, BASE_DIRS) to set first. Set BASE_DIR, RAG_HYBRID_WEIGHT, BASE_DIRS before connecting. You can also paste the ready-made client config above.

Does Local RAG (shinpr) run locally?

Yes - it's a stdio server: it runs on your machine (via npx) with your user's permissions. Your data stays local unless the server itself calls external APIs.

07 · Alternatives to Local RAG (shinpr)

Alternatives to Local RAG (shinpr)

Maintained AI & ML servers if Local RAG (shinpr) isn't the fit.

  1. Fun ASR Transcribe local audio with FunASR and SenseVoice using private, on-device inference. ★ 20,411 · 2026-09-18
  2. Auto TS Automated time series forecasting with model search, anomaly detection, and event risk analysis ★ 1,428 · 2026-08-25
  3. Haiku RAG Local-first agentic RAG with citations - hybrid search, reranking, multimodal document retrieval ★ 609 · 2026-09-17
  4. Plan Exe MCP server for generating rough-draft project plans from natural-language prompts. ★ 401 · 2026-09-13
  5. PageIndex MCP Reasoning-based RAG system for chatting with long PDFs. Supports local and online files. ★ 388 · 2026-07-25
  6. Ruv Swarm Neural network swarm orchestration with WebAssembly acceleration and MCP integration ★ 380 · 2026-08-09

Pairs well with

Servers that cover what Local RAG (shinpr) doesn't - only shown when the pairing reason fits the companion.

  1. Codebase Memory → memory companion memory · ★ 43,715
  2. Memorix → memory companion memory · ★ 785
  3. Supabase → database companion database · ★ 2,910
  4. MongoDB MCP Server → database companion database · ★ 1,131

head to head · Local RAG (shinpr) vs Australian Tax MCP · Visual Memory MCP vs Local RAG (shinpr) · Haiku RAG vs Local RAG (shinpr)

More AI & ML MCP servers · Quesen Deterministic Agent Decision Layer · Sidclaw Governance MCP · Notepatra MCP · Openregistry · Machine Library by Space Frontiers

More TypeScript MCP servers · Sub Agents MCP · L402 Kit · Codebase Chat · Ship Static · Seminara · see all