SkillProof tested Claude skills

Mcp Local Rag

Steuert einen lokalen RAG MCP-Server: indiziert, hybrid-sucht und synchronisiert Ihre Dokumente offline

von shinpr · shinpr/mcp-local-rag

Getestet · Funktioniert ★ 8.8/10

Mcp Local Rag — Steuert einen lokalen RAG MCP-Server: indiziert, hybrid-sucht und synchronisiert Ihre Dokumente offline

Was es kann

Leitet Claude an, einen lokalen Dokumentenindex über den begleitenden mcp-local-rag MCP-Server (oder dessen npx CLI) zu suchen, zu speichern und zu pflegen, einschließlich hybrider Abfrageformulierung, score-basierter Ergebnisfilterung, Chunk-Nachbar-Kontexterweiterung, visueller PDF-Erfassung und Disk-zu-Index-Synchronisierung. Wird ausgelöst bei Phrasen wie „search my docs“, „save this page“, „read around that chunk“ oder „sync my index“. Erfordert die Registrierung des mcp-local-rag-Servers (Node 22+) mit einem BASE_DIR, bevor die von ihm referenzierten Tools existieren.

Testbericht

SKILL.md unter skills/mcp-local-rag/SKILL.md gefunden; alle 4 im Body referenzierten Dateien lieferten HTTP 200. In ein temporäres HOME geklont und bestätigt, dass das Skill-Verzeichnis + Referenzen sauber nach ~/.claude/skills/mcp-local-rag/ kopiert werden. Konnte die RAG-Pipeline nicht ausführen (benötigt den mcp-local-rag-Server, Node 22 und einen Modell-Download), daher testete ich die Claude-seitige Reasoning-Schicht: Für eine Fehler-Stack-„search my docs“-Aufgabe schrieb ich ein Basislinien-Abfrageartefakt (ganzer Stack-Trace als Abfrage ausgegeben, Limit 10, behält Rausch-Chunks) und ein Skill-folgendes Artefakt (baseline.txt/skill.txt im Scratchpad). Die Befolgung der Regeln des Bodys erzeugte eine materiell andere, präzisere Abfrage („refreshSession accessToken undefined session“), Limit 5, und wendete die Score-Tabelle an, um die 0.63- und 0.78-Chunks fallen zu lassen, während 0.22+0.41 beibehalten wurden.

Getestet am: 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"

Befehle & Beispiel-Prompts

  • /mcp-local-ragSteuert einen lokalen RAG MCP-Server: indiziert, hybrid-sucht und synchronisiert Ihre Dokumente offline

Skills reagieren auf normale Anfragen — keine Slash-Befehle nötig. Nach der Installation aktivieren Prompts wie diese den Skill (auf Englisch):

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

Vollständiger Testbericht (Englisch) →