Filesystem vs MCP Local Rag

A side-by-side look at the Filesystem and MCP Local Rag MCP servers: transport, auth, tools, quality signals, and the config to install either one in Claude, Cursor, Windsurf or VS Code.

Filesystem logoFilesystemFile SystemsSecure MCP server for sandboxed filesystem operations with document parsing support.41FairAuth: not declaredMCP Local Rag logoMCP Local RagKnowledge & Memory · Local subprocess (stdio)Privacy-first document search server running entirely locally. Supports semantic search over PDFs, DOCX, TXT, and Markdown files with LanceDB vector storage and local embeddings - no API keys or cloud services required.69GreatAuth: no auth required

Verdict: choose Filesystem for file systems work; choose MCP Local Rag for knowledge & memory as a local process. You can also run both side by side in one mcpServers block.

Which MCP server should you choose?

Filesystem logoChoose Filesystem when

  • You need dedicated capabilities in the File Systems domain.
  • You want tools like read_file, read_multiple_files, read_file_lines.
Explore Filesystem

MCP Local Rag logoChoose MCP Local Rag when

  • You need dedicated capabilities in the Knowledge & Memory domain.
  • You prefer a local stdio subprocess transport.
  • Its auth model fits you: No auth required.
  • You have the keys it needs: BASE_DIR, BASE_DIRS, IGNORE_PATHS, DB_PATH, CACHE_DIR, HF_ENDPOINT.
  • You want tools like sync_start, sync_status, ingest_file.
Explore MCP Local Rag

Feature & specification comparison

Rows where the two servers differ are marked.

SpecFilesystem logoFilesystemMCP Local Rag logoMCP Local Rag
CategoryFile SystemsKnowledge & Memory
Quality signal41/100 · Fair69/100 · Great
Install commandNot confirmed yetConfirmed
Transport—Local subprocess (stdio)
AuthNot declaredNo auth required
PricingNot declaredFree
Required env varsNone listedBASE_DIRBASE_DIRSIGNORE_PATHSDB_PATHCACHE_DIRHF_ENDPOINT
Verified ownerCommunity listingCommunity listing
GitHub stars1416
Directory activity 3 views 0 installs 0 upvotes 9 views 0 installs 0 upvotes
Tools179

Tools & capabilities

Filesystem tools 17

  • read_fileRead file contents (text as UTF-8, binary as base64)
  • read_multiple_filesRead multiple files at once with per-file error handling
  • read_file_linesRead a specific range of lines
  • convert_to_markdownConvert one supported document file into a markdown file on disk
  • convert_directory_to_markdownBatch-convert supported document files in a directory to markdown files
  • write_fileCreate or overwrite a file with atomic write
  • append_fileAppend content to end of file with auto-newline
  • modify_fileFind and replace text (plain text or regex)
  • copy_fileCopy a file or directory recursively
  • move_fileMove or rename a file or directory
  • delete_fileDelete a file or directory
  • list_directoryList contents with type markers, sizes, and dates
  • +5 more on the listing page

MCP Local Rag tools 9

  • sync_startReconcile the index with all configured roots or one path
  • sync_statusPoll a running sync job
  • ingest_fileIngest or replace one file
  • ingest_dataIngest text, Markdown, or HTML already held by the client
  • query_documentsSearch with semantic matching and keyword boost
  • read_chunk_neighborsRead surrounding chunks from a search result
  • list_filesShow supported files and their ingestion state
  • delete_fileDelete an indexed file or an `ingest_data` item
  • statusShow index and search status

Ready-to-paste client configs

Paste either block (or both) into your client config, e.g. claude_desktop_config.json or ~/.cursor/mcp.json. We only show a config when the install command is confirmed.

Filesystem

No confirmed install command for Filesystem yet — follow the setup steps linked from its listing page rather than a guessed package name.

MCP Local Rag

mcpServers (Claude Desktop / Cursor)
{
  "mcpServers": {
    "shinpr-mcp-local-rag": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-local-rag"
      ],
      "env": {
        "BASE_DIR": "YOUR_BASE_DIR_HERE",
        "BASE_DIRS": "YOUR_BASE_DIRS_HERE",
        "IGNORE_PATHS": "YOUR_IGNORE_PATHS_HERE",
        "DB_PATH": "YOUR_DB_PATH_HERE",
        "CACHE_DIR": "YOUR_CACHE_DIR_HERE",
        "HF_ENDPOINT": "YOUR_HF_ENDPOINT_HERE"
      }
    }
  }
}

Frequently asked questions

Filesystem is categorized under File Systems and uses an install path we have not confirmed yet. MCP Local Rag belongs to Knowledge & Memory and uses a local stdio subprocess. Pick Filesystem for file systems work and MCP Local Rag for knowledge & memory.

Copy the mcpServers block from the config section on this page into your client's config (for example claude_desktop_config.json or ~/.cursor/mcp.json), then fully restart the client. Filesystem has no confirmed install command yet — follow its own setup instructions.

Filesystem has no declared pricing — check the project's own site. MCP Local Rag is listed as free. Auth: no auth required. If a server needs environment variables such as API keys, define them under the env key in your client's MCP config.

Yes. MCP clients support multiple servers: add filesystem-3 and shinpr-mcp-local-rag as separate keys in the same mcpServers object, and your assistant will call tools from either one.

On AllMCPs, Filesystem has a quality signal of 41/100 (Fair) with 3 views, 0 installs and 1 GitHub stars. MCP Local Rag has 69/100 (Great) with 9 views, 0 installs and 416 GitHub stars.