SkillProof tested Claude skills

Mcp Local Rag

Steruje lokalnym serwerem RAG MCP: indeksuje, hybrydowo wyszukuje i synchronizuje dokumenty offline

Autor: shinpr · shinpr/mcp-local-rag

Testowano · Działa ★ 8.8/10

Mcp Local Rag — Steruje lokalnym serwerem RAG MCP: indeksuje, hybrydowo wyszukuje i synchronizuje dokumenty offline

Co robi ten skill

Prowadzi Claude do wyszukiwania, zapisywania i utrzymywania lokalnego indeksu dokumentów za pośrednictwem towarzyszącego serwera mcp-local-rag MCP (lub jego npx CLI), obejmując hybrydowe formułowanie zapytań, filtrowanie wyników na podstawie wyników, rozszerzanie kontekstu sąsiadującego z fragmentem, wizualne pobieranie PDF i synchronizację dysk-indeks. Wyzwala się na frazy takie jak „search my docs”, „save this page”, „read around that chunk” lub „sync my index”. Wymaga zarejestrowania serwera mcp-local-rag (Node 22+) z BASE_DIR, zanim narzędzia, do których się odwołuje, będą istnieć.

Raport z testu

Zlokalizowałem SKILL.md w skills/mcp-local-rag/SKILL.md; wszystkie 4 pliki referencyjne zwróciły HTTP 200. Sklonowałem do tymczasowego HOME i potwierdziłem, że katalog umiejętności + referencje kopiują się czysto do ~/.claude/skills/mcp-local-rag/. Nie mogłem uruchomić potoku RAG (wymaga serwera mcp-local-rag, Node 22 i pobrania modelu), więc przetestowałem warstwę rozumowania po stronie Claude: dla zadania „search my docs” ze stosem błędów napisałem artefakt zapytania bazowego (cały stos błędów zrzucony jako zapytanie, limit 10, zachowuje fragmenty szumu) i artefakt zgodny z umiejętnością (baseline.txt/skill.txt w scratchpadzie). Zgodnie z zasadami treści wygenerowano istotnie inne, bardziej precyzyjne zapytanie („refreshSession accessToken undefined session”), limit 5, i zastosowano tabelę wyników, aby odrzucić fragmenty 0.63 i 0.78, zachowując jednocześnie 0.22+0.41.

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

Instalacja

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"

Komendy i przykładowe prompty

  • /mcp-local-ragSteruje lokalnym serwerem RAG MCP: indeksuje, hybrydowo wyszukuje i synchronizuje dokumenty offline

Skille uruchamiają się na zwykłe polecenia — bez komend do zapamiętania. Po instalacji aktywują go prompty takie jak te (po angielsku):

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

Pełny raport →