SkillProof tested Claude skills

Mcp Local Rag

Driver en lokal RAG MCP-server: indekser, hybridsøk, og synkroniser dokumentene dine offline

av shinpr · shinpr/mcp-local-rag

Bestått ★ 8.8/10

Mcp Local Rag — Driver en lokal RAG MCP-server: indekser, hybridsøk, og synkroniser dokumentene dine offline

Hva den gjør

Veileder Claude til å søke, lagre og vedlikeholde en lokal dokumentindeks gjennom den tilhørende mcp-local-rag MCP-serveren (eller dens npx CLI), som dekker hybrid spørringsformulering, poengbasert resultatfiltrering, chunk-nabo kontekstutvidelse, PDF visuell inntak, og disk-til-indeks synkronisering. Utløses på fraser som "search my docs", "save this page", "read around that chunk", eller "sync my index". Krever registrering av mcp-local-rag-serveren (Node 22+) med en BASE_DIR før verktøyene den refererer eksisterer.

Testrapport

Fant SKILL.md på skills/mcp-local-rag/SKILL.md; alle 4 kroppsrefererte filer returnerte HTTP 200. Klonet til en midlertidig HOME og bekreftet at ferdighetskatalogen + referanser kopieres rent til ~/.claude/skills/mcp-local-rag/. Kunne ikke kjøre RAG-pipelinen (trenger mcp-local-rag-serveren, Node 22, og en modellnedlasting), så jeg testet Claude-sidens resonneringslag: for en feilstakk "search my docs"-oppgave skrev jeg en grunnlinje-spørringsartefakt (hele stakksporingen dumpet som spørringen, grense 10, beholder støy-chunks) og en ferdighetsfølgende artefakt (baseline.txt/skill.txt i scratchpad). Etter kroppens regler produserte en vesentlig annerledes, strammere spørring ("refreshSession accessToken undefined session"), grense 5, og anvendte poengtabellen for å droppe 0.63 og 0.78 chunks mens den beholdt 0.22+0.41.

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

Installer

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, hybridsøk, og synkroniser dokumentene dine offline

Skills utløses av vanlige forespørsler — ingen kommandoer å huske. Etter installasjonen 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

Full rapport →