mcp-local-rag

Ingest local documents and query them with hybrid semantic and keyword search.

361|68|Updated Oct 31, 2025
One-click install
npx skills add https://github.com/shinpr/mcp-local-rag --skill mcp-local-rag
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: mcp-local-rag
Source: https://github.com/shinpr/mcp-local-rag/tree/main/skills/mcp-local-rag
Command: npx skills add https://github.com/shinpr/mcp-local-rag --skill mcp-local-rag

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

It solves the problem of finding and correctly answering questions from your own documents quickly, without exposing data to external services.

Core Features & Use Cases

  • Hybrid semantic + keyword search with boosts: Retrieves relevant chunks by combining vector search with BM25-style keyword matching for exact technical terms.
  • On-demand context expansion: Improves grounded answers by reading neighboring semantic chunks when a hit lacks enough surrounding explanation.
  • Local ingestion and management: Ingest local files or raw content, update via re-ingest, and manage indexing with list, status, and delete operations.
  • PDF-friendly ingestion (including optional visual captions): Optionally extracts figure/table/diagram captions from PDFs using a local VLM for searchable visual content.

Quick Start

Ask the AI to ingest your documents and then query: Ingest api-spec.pdf, then ask: What does the API documentation say about authentication?

Frequently Asked Questions about mcp-local-rag

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I perform local semantic search over private PDF documents?

Local semantic search over private PDF documents works by ingesting files into a local retrieval system that combines vector search with BM25 keyword matching. This allows you to query technical terms while keeping data confined to your environment.

What is context expansion in retrieval-augmented generation?

Context expansion in retrieval-augmented generation is a mechanism that reads neighboring semantic chunks when a search hit lacks enough surrounding explanation. It improves grounded answers by automatically expanding the retrieved text boundaries.

Does local retrieval-augmented search work for finding specific function definitions in my notes?

Yes, local retrieval-augmented search works for finding specific function definitions in your notes by using hybrid semantic and keyword matching. It retrieves relevant chunks from your configured document roots to locate exact technical terms.

How do I ingest local files for retrieval-augmented generation without exposing data externally?

You ingest local files for retrieval-augmented generation without exposing data externally by using a local MCP server workflow. This server provides tools to ingest raw content, manage indexing status, and delete files confined to configured document roots.

Can I extract visual captions from PDF diagrams during local document ingestion?

Yes, you can extract visual captions from PDF diagrams during local document ingestion. The system optionally uses a local VLM to extract figure and table captions, making visual content searchable alongside standard text.

What is the best way to manage indexed documents for local semantic search?

The best way to manage indexed documents for local semantic search is through a local MCP server workflow that supports list, status, and delete operations. You can update your index by re-ingesting files as needed.