SkillProof tested Claude skills

Mcp Local Rag

Stuurt een lokale RAG MCP server aan: indexeer, hybrid-search, en synchroniseer je docs offline

Door shinpr · shinpr/mcp-local-rag

Getest · Werkt ★ 8.8/10

Mcp Local Rag — Stuurt een lokale RAG MCP server aan: indexeer, hybrid-search, en synchroniseer je docs offline

Wat het doet

Begeleidt Claude om een lokale documentindex te zoeken, op te slaan en te onderhouden via de bijbehorende mcp-local-rag MCP server (of zijn npx CLI), inclusief hybride query formulering, score-gebaseerde resultaatfiltering, chunk-neighbor context uitbreiding, PDF visual ingest, en disk-to-index sync. Activeert op zinsneden zoals "search my docs", "save this page", "read around that chunk", of "sync my index". Vereist het registreren van de mcp-local-rag server (Node 22+) met een BASE_DIR voordat de tools waarnaar het verwijst bestaan.

Testrapport

SKILL.md gevonden op skills/mcp-local-rag/SKILL.md; alle 4 body-gerefereerde bestanden retourneerden HTTP 200. Gekloond naar een tijdelijke HOME en bevestigd dat de skill dir + referenties netjes kopiëren naar ~/.claude/skills/mcp-local-rag/. Kon de RAG pipeline niet uitvoeren (heeft de mcp-local-rag server, Node 22, en een model download nodig), dus ik testte de Claude-side reasoning layer: voor een error-stack "search my docs" taak schreef ik een basislijn query artefact (hele stack trace gedumpt als de query, limit 10, behoudt ruis chunks) en een skill-volgend artefact (baseline.txt/skill.txt in scratchpad). Het volgen van de regels van de body produceerde een materieel verschillende, strakkere query ("refreshSession accessToken undefined session"), limit 5, en paste de scoretabel toe om de 0.63 en 0.78 chunks te laten vallen terwijl 0.22+0.41 behouden bleef.

Getest op: 2026-07-21 · Claude Code 2.x (agent harness)

Installatie

git clone --depth 1 https://github.com/shinpr/mcp-local-rag.git /tmp/mcp-local-rag-src
mkdir -p ~/.claude/skills
cp -R /tmp/mcp-local-rag-src/skills/mcp-local-rag ~/.claude/skills/mcp-local-rag
# The skill only drives the mcp-local-rag MCP server — its tools (ingest_file, query_documents, sync_start...) do not exist until you register it.
# Requires Node.js 22+. Register the server (replace the path with your docs dir):
# claude mcp add local-rag --scope user --env BASE_DIR=/absolute/path/to/your/documents -- npx -y mcp-local-rag
# First index sync downloads a ~90MB embedding model; opt-in PDF visual mode downloads a local VLM under CACHE_DIR (./models/).
# CLI without MCP: npx mcp-local-rag ingest ./docs/ ; npx mcp-local-rag query "authentication API"

Commando's en voorbeeldprompts

  • /mcp-local-ragStuurt een lokale RAG MCP server aan: indexeer, hybrid-search, en synchroniseer je docs offline

Skills reageren op gewone verzoeken — geen commando's om te onthouden. Na installatie activeren prompts zoals deze de skill (in het Engels):

  • Search my docs for last quarter's notes
  • Save this page into my local RAG index
  • Read around that chunk for more context

Volledig rapport (Engels) →