SkillProof tested Claude skills

Mcp Local Rag

Driver en lokal RAG MCP-server: indekser, hybrid-søg og synkroniser dine dokumenter offline

Af shinpr · shinpr/mcp-local-rag

Testet · Virker ★ 8.8/10

Mcp Local Rag — Driver en lokal RAG MCP-server: indekser, hybrid-søg og synkroniser dine dokumenter offline

Hvad det gør

Guider Claude til at søge, gemme og vedligeholde et lokalt dokumentindeks via den medfølgende mcp-local-rag MCP-server (eller dens npx CLI), dækkende hybrid forespørgselsformulering, score-baseret resultatfiltrering, chunk-nabo kontekstudvidelse, PDF visuel indtagelse og disk-til-indeks synkronisering. Udløses på fraser som "search my docs", "save this page", "read around that chunk" eller "sync my index". Kræver registrering af mcp-local-rag-serveren (Node 22+) med en BASE_DIR, før de værktøjer, den refererer til, eksisterer.

Testrapport

Fandt skills/mcp-local-rag/SKILL.md; alle 4 kropsrefererede filer returnerede HTTP 200. Klonede til en midlertidig HOME og bekræftede, at færdighedsmappen + referencer kopieres rent til ~/.claude/skills/mcp-local-rag/. Kunne ikke køre RAG-pipelinen (kræver mcp-local-rag-serveren, Node 22 og en modeldownload), så jeg testede Claude-sidens ræsonnementslag: for en fejl-stack "search my docs"-opgave skrev jeg en baseline forespørgselsartefakt (hele stack trace dumpet som forespørgslen, limit 10, beholder støj-chunks) og en færdigheds-følgende artefakt (baseline.txt/skill.txt i scratchpad). Efter kroppens regler producerede en væsentligt anderledes, strammere forespørgsel ("refreshSession accessToken undefined session"), limit 5, og anvendte scoretabellen til at fjerne 0.63 og 0.78 chunks, mens 0.22+0.41 blev beholdt.

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

Installation

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"

Kommandoer og eksempelprompter

  • /mcp-local-ragDriver en lokal RAG MCP-server: indekser, hybrid-søg og synkroniser dine dokumenter offline

Skills udløses af almindelige forespørgsler — ingen kommandoer at huske. Efter installationen aktiverer prompter som disse skillen (på engelsk):

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

Læs hele rapporten →