mcp-wsl-exec

一个用于在 Windows Subsystem for Linux (WSL) 环境中执行命令的模型上下文协议 (MCP) 服务器。该服务器提供安全的命令执行，并具有内置的安全特性和验证。

<a href="https://glama.ai/mcp/servers/wv6df94kb8"> <img width="380" height="200" src="https://glama.ai/mcp/servers/wv6df94kb8/badge" /> </a>

特性

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

配置

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

Cline 配置

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

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

Claude Desktop 配置

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

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

API

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

execute_command

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

参数：

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

confirm_command

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

参数：

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

安全特性

危险命令检测

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

• 文件系统操作 (rm, rmdir, mv)
• 系统命令 (shutdown, reboot)
• 包管理 (apt, yum, dnf)
• 文件重定向 (>, >>)
• 权限更改 (chmod, chown)
• 还有更多...

命令清理

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

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

开发

设置

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

pnpm install

3. 构建项目：

pnpm build

4. 在开发模式下运行：

pnpm dev

发布

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

1. 创建一个 changeset：

pnpm changeset

2. 对软件包进行版本控制：

pnpm changeset version

3. 发布到 npm：

pnpm release

贡献

欢迎贡献！ 请随时提交 Pull Request。

许可证

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

致谢

• 构建于 模型上下文协议 之上
• 专为安全的 WSL 命令执行而设计