Skip to main content
Glama

mcp-wsl-exec

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元字符注入
  • 路径遍历尝试
  • 主目录引用
  • 危险的命令链

发展

设置

  1. 克隆存储库
  2. 安装依赖项:
pnpm install
  1. 构建项目:
pnpm build
  1. 以开发模式运行:
pnpm dev

出版

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

  1. 创建变更集:
pnpm changeset
  1. 对包进行版本控制:
pnpm changeset version
  1. 发布到 npm:
pnpm release

贡献

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

执照

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

致谢

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

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 注入和危险命令等漏洞的保护,促进安全命令执行。

  1. 特征
    1. 配置
      1. 克莱恩配置
      2. Claude桌面配置
    2. API
      1. 执行命令
      2. 确认命令
    3. 安全功能
      1. 危险命令检测
      2. 命令清理
    4. 发展
      1. 设置
      2. 出版
    5. 贡献
      1. 执照
        1. 致谢

          Related MCP Servers

          • A
            security
            A
            license
            A
            quality
            An MCP server to run commands.
            Last updated -
            2
            265
            150
            TypeScript
            MIT License
            • Apple
          • A
            security
            A
            license
            A
            quality
            A 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 -
            1
            74
            Python
            MIT License
            • Apple
          • A
            security
            A
            license
            A
            quality
            A 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 -
            20
            143
            2
            TypeScript
            MIT License
          • A
            security
            A
            license
            A
            quality
            A 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 -
            9
            350
            105
            JavaScript
            MIT License

          View all related MCP servers

          MCP directory API

          We provide all the information about MCP servers via our MCP API.

          curl -X GET 'https://glama.ai/api/mcp/v1/servers/spences10/mcp-wsl-exec'

          If you have feedback or need assistance with the MCP directory API, please join our Discord server