Windows CLI MCP Server

基本能力

产品定位

Windows CLI MCP Server 是一个安全命令行交互服务器，旨在为 Windows 系统提供受控的命令行访问能力。

核心功能

• 多 Shell 支持：支持在 PowerShell、Command Prompt (CMD) 和 Git Bash 中执行命令
• SSH 支持：支持通过 SSH 在远程系统上执行命令
• 安全控制：
• 命令和 SSH 命令拦截（完整路径、大小写变体）
• 工作目录验证
• 最大命令长度限制
• 命令日志和历史跟踪
• 智能参数验证
• 可配置性：
• 自定义安全规则
• Shell 特定设置
• SSH 连接配置文件
• 路径限制
• 被阻止的命令列表

适用场景

• 通过 MCP 客户端（如 Claude Desktop）安全地执行本地系统命令
• 通过 SSH 安全地管理远程服务器
• 需要限制命令执行范围和权限的开发环境

工具列表

• execute_command：在指定 shell 中执行命令
• get_command_history：获取执行命令的历史记录
• ssh_execute：通过 SSH 在远程系统上执行命令
• ssh_disconnect：断开 SSH 连接

常见问题解答

• 安全性：服务器默认配置为限制性较强，建议用户根据实际需求配置安全规则
• 配置：可以通过 JSON 配置文件自定义服务器行为
• 使用：需要与 MCP 客户端（如 Claude Desktop）配合使用

使用教程

使用依赖

• Node.js 环境
• npm 或 yarn 包管理器

安装教程

1. 通过 npm 安装服务器：

npx -y @simonb97/server-win-cli

1. 配置 Claude Desktop 使用该服务器，在 claude_desktop_config.json 中添加：

{
  "mcpServers": {
    "windows-cli": {
      "command": "npx",
      "args": ["-y", "@simonb97/server-win-cli"]
    }
  }
}

1. 如需使用特定配置文件，添加 --config 标志：

{
  "mcpServers": {
    "windows-cli": {
      "command": "npx",
      "args": [
        "-y",
        "@simonb97/server-win-cli",
        "--config",
        "path/to/your/config.json"
      ]
    }
  }
}

调试方式

1. 创建默认配置文件：

npx @simonb97/server-win-cli --init-config ./config.json

1. 检查服务器日志以查看命令执行情况
2. 使用 get_command_history 工具查看命令历史记录

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。