Filesystem MCP Server for WSL

基本能力

产品定位

mcp-server-wsl-filesystem 是一个专为 WSL 环境设计的文件系统操作服务器，实现了 Model Context Protocol (MCP)，允许用户在 Windows 主机上无缝访问和操作 WSL 中的文件系统。

核心功能

• 访问任何 WSL 发行版的文件系统
• 在 WSL 中读写文件
• 创建/列出/删除目录
• 移动文件/目录
• 搜索文件
• 获取文件元数据
• 支持多个 WSL 发行版

适用场景

• 在 Windows 主机上管理 WSL 文件系统
• 跨平台文件操作
• 开发环境中需要同时访问 Windows 和 WSL 文件系统的场景

工具列表

• read_file: 读取 WSL 中的文件内容
• read_multiple_files: 同时读取多个文件
• write_file: 在 WSL 中创建或覆盖文件
• edit_file: 对 WSL 中的文件进行选择性编辑
• create_directory: 在 WSL 中创建目录
• list_directory: 列出目录内容
• directory_tree: 获取目录的递归树视图
• move_file: 移动或重命名文件和目录
• search_files: 递归搜索文件和目录
• get_file_info: 获取文件/目录的详细元数据
• list_allowed_directories: 列出服务器允许访问的目录
• list_wsl_distributions: 列出所有可用的 WSL 发行版

常见问题解答

• 该服务器只允许操作通过 args 指定的目录
• 对于大多数用户，使用原始 MCP 服务器和本地网络路径可能更简单

使用教程

使用依赖

• 已正确配置的 Windows Subsystem for Linux (WSL)
• 至少安装了一个 Linux 发行版
• 对于开发：Node.js (v14.0.0 或更高版本) 和 TypeScript

安装教程

1. 安装 Node.js: bash # 从官方 Node.js 网站下载 Windows 安装程序 # 运行安装程序并按照向导完成安装 # 验证安装 node --version npm --version
2. 构建 TypeScript 项目: bash npm install npm run build

调试方式

运行服务器:

node dist/index.js [--distro=distribution_name] <allowed_directory> [additional_directories...]

示例:

# 访问 Ubuntu-20.04 发行版
node dist/index.js --distro=Ubuntu-20.04 /home/user/documents

# 使用默认发行版
node dist/index.js /home/user/documents

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。