STARWARCLOUD STARWAR.AI
返回市场
mcp-wsl-执行器

mcp-wsl-执行器

作者：spences1014 星标更新：2025-11-14
安装使用来源：spider==github.com

项目介绍

mcp-wsl-exec

一个用于Windows + Claude Desktop 用户与 Windows Subsystem for Linux (WSL) 交互的 Model Context Protocol (MCP) 服务器。提供读取信息和安全执行命令的功能。

<a href="https://glama.ai/mcp/servers/wv6df94kb8"> <img width="380" height="200" src="https://gips1.baidu.com/it/u=3682009873,555871393&fm=3081&app=3081&f=PNG?w=760&h=400" /> </a>

⚠️ 重要：谁应该使用这个？

✅ 你应该使用这个如果：

  • 你在使用 Claude Desktop on Windows
  • 你需要与你的 WSL 环境进行交互
  • 你希望向 Claude 提供 WSL 上下文（系统信息、进程、文件等）

❌ 你不需要这个如果：

  • 你在使用 Claude Code（它有原生的 bash 访问）
  • 你在 Linux/macOS 上（使用原生工具）
  • 你只需要 Windows PowerShell/CMD（使用其他 MCP 服务器）

功能

📊 信息收集（只读）

  • 🖥️ 获取系统信息（操作系统、内核、主机名）
  • 📁 浏览目录内容
  • 💾 检查磁盘使用情况
  • ⚙️ 列出环境变量
  • 🔄 监控运行中的进程

🔧 命令执行（带安全措施）

  • 🔒 在 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

该服务器提供了 7 个 MCP 工具：

信息收集（只读） 📊

这些工具提供关于你的 WSL 环境的上下文信息，而不会进行任何更改：

get_system_info

获取系统信息（操作系统版本、内核、主机名）。

参数： 无

get_directory_info

获取目录内容和文件信息。

参数：

  • path (字符串，可选)：目录路径（默认为当前目录）
  • details (布尔值，可选)：显示详细信息（权限、大小等）

get_disk_usage

获取磁盘空间信息。

参数：

  • path (字符串，可选)：要检查的具体路径（默认为所有文件系统）

get_environment

获取环境变量。

参数：

  • filter (字符串，可选)：用于搜索特定变量的过滤模式

list_processes

列出正在运行的进程。

参数：

  • filter (字符串，可选)：按进程名称过滤

命令执行（可能具有破坏性） 🔧

当你需要进行更改或运行自定义命令时使用这些工具：

execute_command

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

参数：

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

注意： 危险命令需要通过 confirm_command 进行确认。

confirm_command

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

参数：

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

安全特性

危险命令检测

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

  • 文件系统操作（rm, rmdir, mv）
  • 系统命令（shutdown, reboot）
  • 包管理（apt, yum, dnf）
  • 文件重定向（>, >>）
  • 权限更改（chmod, chown）
  • 以及其他更多

命令清理

所有命令都会被清理以防止：

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

开发

设置

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

发布

项目使用 changesets 进行版本管理。发布步骤如下：

  1. 创建 changeset：
pnpm changeset
  1. 版本化包：
pnpm changeset version
  1. 发布到 npm：
pnpm release

贡献

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

许可证

MIT 许可证 - 详情见 LICENSE 文件。

致谢