SkillProof tested Claude skills

Mcp Local Rag

Gestisce un server RAG MCP locale: indicizza, cerca in modo ibrido e sincronizza i tuoi documenti offline

di shinpr · shinpr/mcp-local-rag

Promosso ★ 8.8/10

Mcp Local Rag — Gestisce un server RAG MCP locale: indicizza, cerca in modo ibrido e sincronizza i tuoi documenti offline

Cosa fa

Guida Claude a cercare, salvare e mantenere un indice di documenti locale tramite il server MCP mcp-local-rag (o la sua CLI npx), coprendo la formulazione di query ibride, il filtraggio dei risultati basato sul punteggio, l'espansione del contesto dei vicini di chunk, l'ingestione visiva di PDF e la sincronizzazione disco-indice. Si attiva su frasi come "cerca i miei documenti", "salva questa pagina", "leggi intorno a quel chunk" o "sincronizza il mio indice". Richiede la registrazione del server mcp-local-rag (Node 22+) con un BASE_DIR prima che gli strumenti a cui fa riferimento esistano.

Rapporto di test

Ho localizzato SKILL.md in skills/mcp-local-rag/SKILL.md; tutti e 4 i file di riferimento nel corpo hanno restituito HTTP 200. Ho clonato in una HOME temporanea e ho confermato che la directory della skill + i riferimenti si copiano correttamente in ~/.claude/skills/mcp-local-rag/. Non ho potuto eseguire la pipeline RAG (richiede il server mcp-local-rag, Node 22 e un download del modello), quindi ho testato lo strato di ragionamento lato Claude: per un task "cerca i miei documenti" con stack di errori ho scritto un artefatto di query di base (intera traccia dello stack scaricata come query, limite 10, mantiene chunk di rumore) e un artefatto conforme alla skill (baseline.txt/skill.txt nello scratchpad). Seguendo le regole del corpo è stata prodotta una query materialmente diversa e più precisa ("refreshSession accessToken undefined session"), limite 5, e ha applicato la tabella dei punteggi per eliminare i chunk 0.63 e 0.78 mantenendo 0.22+0.41.

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

Installazione

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"

Comandi e prompt di esempio

  • /mcp-local-ragGestisce un server RAG MCP locale: indicizza, cerca in modo ibrido e sincronizza i tuoi documenti offline

Gli skill si attivano con richieste in linguaggio naturale, senza comandi da ricordare. Dopo l'installazione, prompt come questi lo attivano (in inglese):

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

Rapporto completo →