Mcp Local Rag

Řídí lokální RAG MCP server: indexuje, hybridně vyhledává a synchronizuje vaše dokumenty offline

od shinpr · shinpr/mcp-local-rag

Otestováno · Funguje ★ 8.8/10

Mcp Local Rag — Řídí lokální RAG MCP server: indexuje, hybridně vyhledává a synchronizuje vaše dokumenty offline

Co umí

Navádí Claude k vyhledávání, ukládání a udržování lokálního indexu dokumentů prostřednictvím doprovodného mcp-local-rag MCP serveru (nebo jeho npx CLI), pokrývající hybridní formulaci dotazů, filtrování výsledků na základě skóre, rozšíření kontextu sousedních chunků, vizuální ingest PDF a synchronizaci disku s indexem. Spouští se na fráze jako "search my docs", "save this page", "read around that chunk" nebo "sync my index". Vyžaduje registraci mcp-local-rag serveru (Node 22+) s BASE_DIR předtím, než existují nástroje, na které odkazuje.

Testovací report

Nalezeno SKILL.md v skills/mcp-local-rag/SKILL.md; všechny 4 soubory odkazované v těle vrátily HTTP 200. Naklonováno do dočasného HOME a potvrzeno, že adresář dovednosti + reference se čistě zkopírují do ~/.claude/skills/mcp-local-rag/. Nemohl jsem spustit RAG pipeline (potřebuje mcp-local-rag server, Node 22 a stažení modelu), takže jsem testoval vrstvu uvažování na straně Claude: pro úkol "search my docs" s chybovým stackem jsem napsal základní artefakt dotazu (celý stack trace vypsaný jako dotaz, limit 10, zachovává šumové chunky) a artefakt dodržující dovednost (baseline.txt/skill.txt ve scratchpadu). Dodržení pravidel těla vytvořilo materiálně odlišný, přesnější dotaz ("refreshSession accessToken undefined session"), limit 5, a aplikovalo tabulku skóre pro vyřazení chunků 0.63 a 0.78 při zachování 0.22+0.41.

Testováno: 2026-07-21 · Claude Code 2.x (agent harness)

Instalace

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"

Příkazy a ukázkové prompty

  • /mcp-local-ragŘídí lokální RAG MCP server: indexuje, hybridně vyhledává a synchronizuje vaše dokumenty offline

Skilly se spouštějí běžnými požadavky — žádné příkazy k zapamatování. Po instalaci ho aktivují prompty jako tyto (anglicky):

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