MCP Wsl Exec

MCP-WSL-Exec（注：这里的“MCP”可能是一个特定项目、公司或系统的缩写，根据上下文可能有不同的翻译，但在此直接保留原样；“WSL”通常指Windows Subsystem for Linux，即Windows上的Linux子系统；“Exec”可能指执行或执行器）

一个模型上下文协议（MCP）服务器用于 Windows + Claude 桌面版用户 与Windows Subsystem for Linux（WSL）进行交互。提供仅读信息收集和安全命令执行两种功能。

⚠️ 重要提示：谁应该使用这个？

✅ 如果以下情况，你应该使用这个：

• 你在使用 Windows版的Claude Desktop
• 你需要与你的WSL环境进行交互
• 您想为Claude提供WSL上下文（系统信息、进程、文件等）

❌ 如果以下情况，则不需要这个：

• 你正在使用 克劳德·科德 （它具有原生的bash访问权限）
• 你正在使用 Linux/macOS（请使用原生工具）
• 您只需要Windows PowerShell/CMD（使用不同的MCP服务器）

特点/功能

📊 信息收集（只读）

• 🖥️ 获取系统信息（操作系统、内核、主机名）
• 📁 浏览目录内容
• 💾 检查磁盘使用情况
• ⚙️ 列出环境变量
• 🔄 监控运行中的进程

🔧 命令执行（安全模式）

• 在WSL环境中安全执行命令
• ⚡ 内置安全功能：

- 危险命令检测 - 命令确认系统 - 防止路径遍历攻击 - 命令净化（或命令消毒）

• 📁 工作目录支持
• ⏱️ 命令超时功能
• 🛡️ 防止外壳注入攻击

配置

这台服务器需要通过您的MCP客户端进行配置。以下是 不同环境下的示例：

Cline 配置

在您的Cline MCP设置中添加以下内容：

{
	"mcpServers": {
		"mcp-wsl-exec": {
			"command": "npx",
			"args": ["-y", "mcp-wsl-exec"]
		}
	}
}

克劳德桌面配置

将此添加到您的Claude桌面配置中：

{
	"mcpServers": {
		"mcp-wsl-exec": {
			"command": "npx",
			"args": ["-y", "mcp-wsl-exec"]
		}
	}
}

API

服务器提供了7种MCP工具：

信息收集（只读）📊

这些工具可以在不改变任何设置的情况下，提供有关您WSL（Windows Subsystem for Linux）环境的信息：

获取系统信息

获取系统信息（操作系统版本、内核、主机名）。

参数： 无

获取目录信息

获取目录内容和文件信息。

参数：

• path (字符串，可选)：目录路径（默认为当前目录）
• details (布尔值，可选)：显示详细信息（权限、大小等）

获取磁盘使用情况

获取磁盘空间信息。

参数：

• path (字符串，可选)：要检查的特定路径（默认为所有文件系统）

获取环境

获取环境变量。

参数：

• filter （字符串，可选）：用于搜索特定变量的过滤模式

列出进程

列出正在运行的进程。

参数：

• filter （字符串，可选）：按进程名称过滤

命令执行（可能具有破坏性）🔧

当你需要进行更改或运行自定义命令时，请使用这些工具：

执行命令

在WSL中执行命令时进行安全检查和验证。

参数：

• command （字符串，必需）：要执行的命令
• working_dir （字符串，可选）：命令执行的工作目录
• timeout （数字，可选）：以毫秒为单位的超时时间

注： 危险命令将需要通过（某种方式）进行确认 confirm_command.

确认命令

确认执行一条已被安全检查标记为危险的指令。

参数：

• confirmation_id (字符串，必填)：从 execute_command 接收到的确认ID
• confirm (布尔值，必需): 是否继续执行命令

安全特性

危险指令检测

服务器维护着一个可能包含危险命令的列表，这些命令 在执行前需要获得明确确认，包括：

• 文件系统操作（删除文件rm，删除目录rmdir，移动文件mv）
• 系统命令（关机、重启）
• 包管理（apt、yum、dnf）
• 文件重定向（>，>>）
• 权限更改（chmod，chown）
• 以及更多。。。

命令消毒（或命令净化）

所有命令都经过净化处理，以防止：

• Shell元字符注入
• 路径遍历尝试
• 主目录引用
• 危险的命令链接（或命令串联）

发展

设置

1. 克隆仓库
2. 安装依赖项：

pnpm install

1. 构建项目：

pnpm build

1. 以开发模式运行：

pnpm dev

出版

该项目使用更改集进行版本管理。要发布：

1. 创建更改集：

pnpm changeset

1. 打包版本：

pnpm changeset version

1. 发布到npm：

pnpm release

贡献

欢迎贡献！请随时提交拉取请求。

许可证

MIT 许可证 - 详见 许可证 文件中有详细信息。

致谢

• 建立在……之上

模型上下文协议

• 设计用于安全执行WSL命令