SkillProof tested Claude skills

Mcp Local Rag

Controla un servidor RAG MCP local: indexa, busca híbrido y sincroniza tus documentos sin conexión

Por shinpr · shinpr/mcp-local-rag

Probado · Funciona ★ 8.8/10

Mcp Local Rag — Controla un servidor RAG MCP local: indexa, busca híbrido y sincroniza tus documentos sin conexión

Qué hace

Guía a Claude para buscar, guardar y mantener un índice de documentos local a través del servidor mcp-local-rag MCP complementario (o su CLI npx), cubriendo la formulación de consultas híbridas, el filtrado de resultados basado en puntuación, la expansión de contexto de fragmentos vecinos, la ingesta visual de PDF y la sincronización de disco a índice. Se activa con frases como "search my docs", "save this page", "read around that chunk" o "sync my index". Requiere registrar el servidor mcp-local-rag (Node 22+) con un BASE_DIR antes de que existan las herramientas que referencia.

Informe de la prueba

Localicé SKILL.md en skills/mcp-local-rag/SKILL.md; los 4 archivos referenciados en el cuerpo devolvieron HTTP 200. Cloné en un HOME temporal y confirmé que el directorio de la habilidad + las referencias se copian limpiamente a ~/.claude/skills/mcp-local-rag/. No pude ejecutar el pipeline RAG (necesita el servidor mcp-local-rag, Node 22 y una descarga de modelo), así que probé la capa de razonamiento del lado de Claude: para una tarea de "search my docs" de pila de errores, escribí un artefacto de consulta de línea base (toda la traza de pila volcada como consulta, límite 10, mantiene fragmentos de ruido) y un artefacto siguiendo la habilidad (baseline.txt/skill.txt en scratchpad). Siguiendo las reglas del cuerpo, se produjo una consulta materialmente diferente y más ajustada ("refreshSession accessToken undefined session"), límite 5, y se aplicó la tabla de puntuación para descartar los fragmentos 0.63 y 0.78 mientras se mantenían 0.22+0.41.

Probado el: 2026-07-21 · Claude Code 2.x (agent harness)

Instalación

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"

Comandos y prompts de ejemplo

  • /mcp-local-ragControla un servidor RAG MCP local: indexa, busca híbrido y sincroniza tus documentos sin conexión

Los skills se activan con peticiones en lenguaje natural, sin comandos que memorizar. Tras instalarlo, prompts como estos lo activan (en inglés):

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

Informe completo →