WSL Filesystem Server

Example Use Cases

• 1

  Access, read, and write files inside a specific WSL distribution from a Windows host while honoring a configured set of allowed directories.

• 2

  Perform fast recursive file and content searches across large WSL directory trees (supports regex, case-insensitive search, include/exclude patterns, and context lines).

• 3

  Safely edit files programmatically with multi-line matching, indentation preservation and git-style diff previews, or to read very large files in parts.

Description

This MCP server exposes and manipulates files inside Windows Subsystem for Linux (WSL) distributions from the Windows host. It leverages native Linux commands (find, grep, etc.) inside WSL for much faster directory listing and content searching than recursive Node.js fs traversal. The server supports read/write, partial reads for large files, batch reads, selective edits with diff previews, directory tree listing, moving files, and advanced search features (regex, include/exclude patterns, context lines). It also supports selecting multiple WSL distributions and limits operations to configured allowed directories for safety.