SkillProof tested Claude skills

Mcp Local Rag

Pilote un serveur RAG MCP local : indexe, recherche hybride et synchronise vos documents hors ligne

par shinpr · shinpr/mcp-local-rag

Testé · Fonctionne ★ 8.8/10

Mcp Local Rag — Pilote un serveur RAG MCP local : indexe, recherche hybride et synchronise vos documents hors ligne

Ce que fait

Guide Claude pour rechercher, enregistrer et maintenir un index de documents local via le serveur MCP mcp-local-rag (ou son CLI npx) compagnon, couvrant la formulation de requêtes hybrides, le filtrage des résultats basé sur le score, l'expansion du contexte des voisins de chunk, l'ingestion visuelle de PDF et la synchronisation disque-index. Se déclenche sur des phrases comme "search my docs", "save this page", "read around that chunk" ou "sync my index". Nécessite d'enregistrer le serveur mcp-local-rag (Node 22+) avec un BASE_DIR avant que les outils qu'il référence n'existent.

Rapport de test

J'ai localisé SKILL.md à skills/mcp-local-rag/SKILL.md; les 4 fichiers référencés dans le corps ont renvoyé HTTP 200. J'ai cloné dans un HOME temporaire et confirmé que le répertoire de la compétence + les références sont copiés proprement dans ~/.claude/skills/mcp-local-rag/. Je n'ai pas pu exécuter la pipeline RAG (nécessite le serveur mcp-local-rag, Node 22 et un téléchargement de modèle), j'ai donc testé la couche de raisonnement côté Claude : pour une tâche "search my docs" de pile d'erreurs, j'ai écrit un artefact de requête de référence (toute la trace de pile vidée comme requête, limite 10, conserve les chunks de bruit) et un artefact suivant la compétence (baseline.txt/skill.txt dans le bloc-notes). Suivre les règles du corps a produit une requête matériellement différente et plus concise ("refreshSession accessToken undefined session"), limite 5, et a appliqué le tableau de scores pour supprimer les chunks 0.63 et 0.78 tout en conservant 0.22+0.41.

Testé le: 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"

Commandes et exemples de prompts

  • /mcp-local-ragPilote un serveur RAG MCP local : indexe, recherche hybride et synchronise vos documents hors ligne

Les skills se déclenchent sur des demandes en langage courant — aucune commande à retenir. Après installation, des prompts comme ceux-ci l'activent (en anglais) :

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

Rapport complet →