SkillProof tested Claude skills

Mcp Local Rag

Driver en lokal RAG MCP-server: indexera, hybridsöka och synkronisera dina dokument offline

av shinpr · shinpr/mcp-local-rag

Testad · Fungerar ★ 8.8/10

Mcp Local Rag — Driver en lokal RAG MCP-server: indexera, hybridsöka och synkronisera dina dokument offline

Vad den gör

Vägleder Claude att söka, spara och underhålla ett lokalt dokumentindex via den medföljande mcp-local-rag MCP-servern (eller dess npx CLI), som täcker hybridfrågeformulering, poängbaserad resultatfiltrering, chunk-granne-kontextutvidgning, visuell PDF-ingest och disk-till-index-synkronisering. Utlöses på fraser som "search my docs", "save this page", "read around that chunk" eller "sync my index". Kräver registrering av mcp-local-rag-servern (Node 22+) med en BASE_DIR innan de verktyg den refererar existerar.

Testrapport

Hittade SKILL.md på skills/mcp-local-rag/SKILL.md; alla 4 kroppsrefererade filer returnerade HTTP 200. Klonade till en temporär HOME och bekräftade att färdighetskatalogen + referenser kopieras rent till ~/.claude/skills/mcp-local-rag/. Kunde inte köra RAG-pipelinen (behöver mcp-local-rag-servern, Node 22 och en modellnedladdning), så jag testade Claude-sidans resonemangslager: för en felstack "search my docs"-uppgift skrev jag en baslinjefrågeartefakt (hela stackspårningen dumpad som frågan, gräns 10, behåller brusbitar) och en färdighetsföljande artefakt (baseline.txt/skill.txt i scratchpad). Att följa kroppens regler producerade en materiellt annorlunda, snävare fråga ("refreshSession accessToken undefined session"), gräns 5, och tillämpade poängtabellen för att släppa 0.63- och 0.78-bitarna samtidigt som 0.22+0.41 behölls.

Testad: 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"

Kommandon och exempelprompter

  • /mcp-local-ragDriver en lokal RAG MCP-server: indexera, hybridsöka och synkronisera dina dokument offline

Skills triggas av vanliga förfrågningar — inga kommandon att memorera. Efter installationen aktiverar prompter som dessa skillen (på engelska):

  • 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 hela rapporten →