Minimal local RAG MCP server for document folders
Wellknown found it in public sources; nobody has proven control of it yet. Claiming takes one click if the repository is under your GitHub account, or a small file on your domain otherwise. Verified owners get the badge, 15-minute checks, status alerts, edits that outrank crawled data, and a ranking boost.
Agents can do it too: POST https://wellknown.network/api/v1/claims with {"agent":"micro-rag-mcp","method":"well_known_file"} — machine-readable steps at claim.json, guide at /docs/claim.
Everything here was measured by our prober or read from a registry. Nothing is self-reported.
Attributed to the source that supplied each field. Treated as claims, not facts.
# micro-rag-mcp: Minimal local RAG MCP server Minimal, local Retrieval Augmented Generation indexing and search MCP server for folders of documents. Designed for multiple instances via uvx with different data folders. Stores a persistent FAISS index under each data folder in an index directory. ## Goals - Minimal and elegant: a single stdio MCP server process with two tools: search and reindex - Local only: no network calls; works offline once models are downloaded - Fast startup: incremental indexing by file mtime with content checksum verification - Low footprint: sentence-transformers all-MiniLM-L6-v2, FAISS IndexFlatIP, numpy ## Default behavior - Embeddings: sentence-transformers all-MiniLM-L6-v2 - File types: .txt, .md, .pdf, .docx - Chunking: 1000 characters, 200 overlap, paragraph aware - Similarity: cosine via L2 normalized vectors and FAISS IndexFlatIP - Index location: <data_folder>/index - Startup: scan files and apply incremental changes to the index - Concurrency: simple file lock index.lock to serialize reindex operations - Logging: human logs to stderr; tool results are structured ## Multi-instance support - You can run multiple independent MCP server instances by specifying different `--title` and `--inst` arguments for each process. - Both `--title` and `--inst` are **required**. - The `--title` is used as the FastMCP server name. - The `--inst` is passed verbatim as the FastMCP instructions (can be a sentence, multi-line, etc). - The default index location remains `<data_folder>/index` for all instances unless you override with `--index-folder`. ### Example MCP config with two instances ```json { "mcpServers": { "team_alpha": { "command": "uvx", "args": [ "micro-rag-mcp@0.1.4", "--data-folder", "/docs/teamA", "--title", "Secret Islands", "--inst", "Team Alpha read-only mode with nightly refresh" ] }, "team_beta": { "command": "uvx", "args": [ "micro-rag-mcp…
Mapped onto the structured taxonomy from declared text and observed tool names. Confidence shown for derived entries.
Every source is kept verbatim. Field changes are logged as events.