mcp-wsl-exec
用于在 Windows 的 Linux 子系统 (WSL) 环境中执行命令的模型上下文协议 (MCP) 服务器。此服务器通过内置的安全功能和验证来提供安全的命令执行。
特征
- 🔒 在 WSL 环境中安全执行命令
- ⚡ 内置安全功能:
- 危险命令检测
- 指令确认系统
- 路径遍历预防
- 命令清理
- 📁 工作目录支持
- ⏱️ 命令超时功能
- 🔍 详细的命令输出格式
- ❌错误处理和验证
- 🛡️ 防止 shell 注入
配置
此服务器需要通过您的 MCP 客户端进行配置。以下是不同环境的示例:
克莱恩配置
将其添加到您的 Cline MCP 设置中:
Claude桌面配置
将其添加到您的 Claude Desktop 配置中:
API
服务器实现了两个 MCP 工具:
执行命令
在 WSL 中执行带有安全检查和验证的命令。
参数:
command
(字符串,必需):要执行的命令working_dir
(字符串,可选):命令执行的工作目录timeout
(数字,可选):超时时间(以毫秒为单位)
确认命令
确认执行安全检查标记的危险命令。
参数:
confirmation_id
(字符串,必需):从execute_command收到的确认IDconfirm
(布尔值,必需):是否继续执行命令
安全功能
危险命令检测
服务器维护着一个潜在危险的命令列表,这些命令在执行前需要明确确认,包括:
- 文件系统操作(rm、rmdir、mv)
- 系统命令(关机、重启)
- 包管理(apt、yum、dnf)
- 文件重定向(>、>>)
- 权限更改(chmod、chown)
- 还有更多...
命令清理
所有命令都经过清理以防止:
- Shell元字符注入
- 路径遍历尝试
- 主目录引用
- 危险的命令链
发展
设置
- 克隆存储库
- 安装依赖项:
- 构建项目:
- 以开发模式运行:
出版
该项目使用变更集进行版本管理。要发布:
- 创建变更集:
- 对包进行版本控制:
- 发布到 npm:
贡献
欢迎贡献代码!欢迎提交 Pull 请求。
执照
MIT 许可证 - 有关详细信息,请参阅LICENSE文件。
致谢
- 基于模型上下文协议
- 专为安全执行 WSL 命令而设计
You must be authenticated.
local-only server
The server can only run on the client's local machine because it depends on local resources.
适用于 Windows Subsystem for Linux 环境的安全 MCP 服务器,通过广泛的验证和针对 Shell 注入和危险命令等漏洞的保护,促进安全命令执行。
Related Resources
Related MCP Servers
- AsecurityAlicenseAqualityAn MCP server to run commands.Last updated -2265150TypeScriptMIT License
- AsecurityAlicenseAqualityA secure shell command execution server implementing the Model Context Protocol (MCP). This server allows remote execution of whitelisted shell commands with support for stdin input.Last updated -174PythonMIT License
- AsecurityAlicenseAqualityA secure MCP server for executing whitelisted shell commands with resource and timeout controls, designed for integration with Claude and other MCP-compatible LLMs.Last updated -201432TypeScriptMIT License
- AsecurityAlicenseAqualityA Model Context Protocol server that provides secure command-line access to Windows systems, allowing MCP clients like Claude Desktop to safely execute commands in PowerShell, CMD, and Git Bash shells with configurable security controls.Last updated -9350105JavaScriptMIT License