What is Filesystem MCP Server for WSL?
Filesystem MCP Server for WSL is a Node.js server implementing the Model Context Protocol (MCP), specifically designed for filesystem operations in Windows Subsystem for Linux (WSL). It is a fork of the original Filesystem MCP Server but completely reimagined for WSL environments, leveraging native Linux commands inside WSL for faster file listing and content search. It is intended for users who need high-performance file operations across WSL distributions from Windows.
How to use Filesystem MCP Server for WSL?
Install via npm (mcp-server-wsl-filesystem). For Claude Desktop, configure claude_desktop_config.json with the npx command and the desired WSL distribution and allowed directories. You can also run it directly from the command line: node dist/index.js [--distro=distribution_name] <allowed_directory> [additional_directories...]. Build the project first with npm install and npm run build.
Key features of Filesystem MCP Server for WSL
- Access any WSL distribution from Windows.
- Read, write, and edit files in WSL from the Windows host.
- Create, list, and delete directories within WSL.
- Move files and directories across the WSL filesystem.
- Search files by name or text content with pattern matching.
- Get detailed file metadata from the WSL filesystem.
- Support for multiple WSL distributions simultaneously.
Use cases of Filesystem MCP Server for WSL
- Manage WSL project files directly from a Windows-based AI assistant.
- Perform rapid file searches across large WSL directory trees using native Linux commands.
- Edit configuration files inside a specific WSL distribution without leaving Windows.
- Move or copy files between different WSL distributions from a single MCP tool.
评论