local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

Allows execution of commands in Windows Subsystem for Linux (WSL) environments with security features
Provides protection against shell injection and secure command execution with safety features

mcp-wsl-exec

用于在 Windows 的 Linux 子系统 (WSL) 环境中执行命令的模型上下文协议 (MCP) 服务器。此服务器通过内置的安全功能和验证来提供安全的命令执行。

特征

🔒 在 WSL 环境中安全执行命令
⚡ 内置安全功能：
- 危险命令检测
- 指令确认系统
- 路径遍历预防
- 命令清理
📁 工作目录支持
⏱️ 命令超时功能
🔍 详细的命令输出格式
❌错误处理和验证
🛡️ 防止 shell 注入

配置

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

克莱恩配置

将其添加到您的 Cline MCP 设置中：

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

Claude桌面配置

将其添加到您的 Claude Desktop 配置中：

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

API

服务器实现了两个 MCP 工具：

执行命令

在 WSL 中执行带有安全检查和验证的命令。

参数：

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

确认命令

确认执行安全检查标记的危险命令。

参数：

confirmation_id （字符串，必需）：从execute_command收到的确认ID
confirm （布尔值，必需）：是否继续执行命令

安全功能

危险命令检测

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

文件系统操作（rm、rmdir、mv）
系统命令（关机、重启）
包管理（apt、yum、dnf）
文件重定向（>、>>）
权限更改（chmod、chown）
还有更多...

命令清理

所有命令都经过清理以防止：

Shell元字符注入
路径遍历尝试
主目录引用
危险的命令链

发展

设置

克隆存储库
安装依赖项：

pnpm install

构建项目：

pnpm build

以开发模式运行：

pnpm dev

出版

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

创建变更集：

pnpm changeset

对包进行版本控制：

pnpm changeset version

发布到 npm：

pnpm release

贡献

欢迎贡献代码！欢迎提交 Pull 请求。

执照

MIT 许可证 - 有关详细信息，请参阅LICENSE文件。

致谢

基于模型上下文协议
专为安全执行 WSL 命令而设计

You must be authenticated.

A

security – no known vulnerabilities

A

license - permissive license

A

quality - confirmed to work

Tools

适用于 Windows Subsystem for Linux 环境的安全 MCP 服务器，通过广泛的验证和针对 Shell 注入和危险命令等漏洞的保护，促进安全命令执行。

Related Resources

Reddit Discussion about this server