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 connecting AI & ML tools to Claude, Cursor, VS Code, or another MCP client. The project is written in TypeScript.

VERIFIED ACTIVE

LAST COMMIT 2026-08-23 · ★ 371 · #1 OF 95 MAINTAINED AI & ML · VERIFIED 2026-08-25

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.0 · 2026-08-23

Store PDF figure and table crops and supported DOCX inline images with their semantic chunks. · Return stored images with matching MCP and CLI query results without requiring PDF VLM captioning. · Add STORE_IMAGES=true…

v0.17.4 · 2026-08-12

Added · Added repeatable --base-dir <path> support to the sync CLI command. · --base-dir can be placed before or after the optional sync path. · CLI-provided roots take precedence over BASE_DIRS and BASE_DIR; existing…

v0.17.3 · 2026-08-03

Updated the MCP SDK, JSDOM, LanceDB, and dpdm dependencies. · Refreshed the pnpm lockfile and patched security-sensitive transitive dependencies where supported. · Updated package and MCP server metadata to version…

04 · Who maintains Local RAG (shinpr)

mcp-local-rag is maintained by shinpr. We track 3 MCP servers from shinpr - 3 actively maintained, 622 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 ★ 155
  2. sub-agents-mcp MCP server for delegating tasks to specialized AI sub-agents across coding tools ★ 96

05 · Facts

repository
github.com/shinpr/mcp-local-rag
category
AI & ML - ranked #1 of 95 actively-maintained AI & ML servers as of 2026-08-25.
release cadence
10+ releases in the last 90 days (latest 2026-08-23)
registry
io.github.shinpr/mcp-local-rag (active, first published 2025-10-31 · 47 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-08-25, its last commit was 2026-08-23 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,003 · 2026-08-24
  2. Airweave Search MCP server for searching Airweave collections with natural language queries. ★ 6,564 · 2026-06-05
  3. Auto TS Automated time series forecasting with model search, anomaly detection, and event risk analysis ★ 1,430 · 2026-08-23
  4. Haiku RAG Local-first agentic RAG with citations - hybrid search, reranking, multimodal document retrieval ★ 584 · 2026-08-24
  5. Plan Exe MCP server for generating rough-draft project plans from natural-language prompts. ★ 397 · 2026-08-23
  6. PageIndex MCP Reasoning-based RAG system for chatting with long PDFs. Supports local and online files. ★ 380 · 2026-07-25

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 · ★ 40,198
  2. Memorix → memory companion memory · ★ 688
  3. Supabase → database companion database · ★ 2,871
  4. MongoDB MCP Server → database companion database · ★ 1,106

head to head · DeepSeek MCP Server vs Local RAG (shinpr) · Airweave Search vs Local RAG (shinpr) · Ruv Swarm vs Local RAG (shinpr)

More AI & ML MCP servers · Quesen Deterministic Agent Decision Layer · Sidclaw Governance MCP · Notepatra MCP · Openregistry · Spacefrontiers MCP Server

More TypeScript MCP servers · Sub Agents MCP · L402 Kit · Ship Static · Vecline · see all