mcp-wsl-exec

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

特征

• 🔒 在 WSL 环境中安全执行命令

• ⚡ 内置安全功能：

  • 危险命令检测

  • 指令确认系统

  • 路径遍历预防

  • 命令清理

• 📁 工作目录支持

• ⏱️ 命令超时功能

• 🔍 详细的命令输出格式

• ❌错误处理和验证

• 🛡️ 防止 shell 注入

Related MCP server: Terminal Controller for MCP

配置

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

克莱恩配置

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

Claude桌面配置

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

API

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

执行命令

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

参数：

• command （字符串，必需）：要执行的命令

• working_dir （字符串，可选）：命令执行的工作目录

• timeout （数字，可选）：超时时间（以毫秒为单位）

确认命令

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

参数：

• confirmation_id （字符串，必需）：从execute_command收到的确认ID

• confirm （布尔值，必需）：是否继续执行命令

安全功能

危险命令检测

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

• 文件系统操作（rm、rmdir、mv）

• 系统命令（关机、重启）

• 包管理（apt、yum、dnf）

• 文件重定向（>、>>）

• 权限更改（chmod、chown）

• 还有更多...

命令清理

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

• Shell元字符注入

• 路径遍历尝试

• 主目录引用

• 危险的命令链

发展

设置

1. 克隆存储库

2. 安装依赖项：

3. 构建项目：

4. 以开发模式运行：

出版

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

1. 创建变更集：

2. 对包进行版本控制：

3. 发布到 npm：

贡献

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

执照

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

致谢

• 基于模型上下文协议

• 专为安全执行 WSL 命令而设计