Windows命令行MCP服务器

你是否曾经希望AI能够安全地执行Windows命令行操作，帮你管理系统、创建项目、获取系统信息，而不用担心安全问题？今天要介绍的开源项目Windows命令行MCP服务器，正是为了实现这个目标而设计的。它提供了一个安全的MCP服务器，允许AI模型与Windows命令行功能安全交互。

项目基本信息

一、项目介绍

Windows命令行MCP服务器是一个让AI能够安全执行Windows命令行操作的MCP工具。它提供了命令白名单、输入验证等安全机制，防止破坏性系统操作。

这个服务器提供了以下工具：

• execute_command：运行Windows CLI命令
• execute_powershell：执行PowerShell脚本
• create_project：安全地创建新的开发项目
• list_running_processes：检索活动的系统进程
• get_system_info：收集系统配置详细信息
• get_network_info：检索网络适配器信息
• get_scheduled_tasks：列出并查询系统任务
• get_service_info：管理和查询Windows服务
• list_allowed_commands：列出服务器可以执行的所有命令

二、核心优势

安全设计

采用多层安全防护：

• 命令白名单机制
• 严格的输入验证
• 防止破坏性系统操作
• 可配置的安全级别

开发工具支持

支持React、Node.js和Python项目的安全创建。

系统交互全面

覆盖Windows系统交互的多个方面：

• CLI命令执行
• PowerShell脚本
• 系统信息检索
• 网络信息获取
• 进程和服务管理
• 计划任务查询

灵活配置

支持默认安全模式、扩展模式，可自定义允许的命令列表。

三、适用场景

Windows系统管理

让AI安全地执行系统管理任务，如查看进程、服务、计划任务。

开发环境自动化

AI可以自动创建React、Node.js、Python项目，配置开发环境。

系统监控

AI可以定期获取系统信息、网络状态、进程列表。

运维自动化

安全地执行授权的命令行操作，自动化运维任务。

四、安装教程

系统要求

安装步骤

第一步：克隆项目并安装依赖

git clone https://github.com/alxspiker/Windows-Command-Line-MCP-Server.git
cd Windows-Command-Line-MCP-Server
npm install
npm run build

第二步：配置Claude Desktop

找到配置文件：

• %APPDATA%\Claude\claude_desktop_config.json

添加配置：

{
  "mcpServers": {
    "windows-cmd": {
      "command": "node",
      "args": ["C:\\path\\to\\dist\\index.js"]
    }
  }
}

第三步：通过Smithery安装（可选）

npx -y @smithery/cli install @alxspiker/Windows-Command-Line-MCP-Server --client claude

第四步：重启Claude Desktop

保存配置后，重启Claude Desktop。

五、使用示例

配置完成后，你就可以在MCP客户端中使用自然语言来执行Windows命令行操作了。

示例1：执行安全命令

用户指令：“显示当前目录内容”

AI会调用execute_command工具：

{
  "command": "dir"
}

示例2：执行PowerShell

用户指令：“获取系统所有进程信息”

AI会调用execute_powershell工具：

{
  "script": "Get-Process | Select-Object -First 10"
}

示例3：创建项目

用户指令：“创建一个React项目”

AI会调用create_project工具：

{
  "type": "react",
  "name": "my-app"
}

支持的项目类型：React、Node.js、Python。

示例4：获取系统信息

用户指令：“获取系统配置信息”

AI会调用get_system_info工具。

示例5：列出进程

用户指令：“列出所有正在运行的进程”

AI会调用list_running_processes工具。

示例6：网络信息

用户指令：“获取网络适配器信息”

AI会调用get_network_info工具。

示例7：计划任务

用户指令：“列出所有计划任务”

AI会调用get_scheduled_tasks工具。

示例8：服务信息

用户指令：“查询所有Windows服务的状态”

AI会调用get_service_info工具。

示例9：查看允许的命令

用户指令：“列出所有允许执行的命令”

AI会调用list_allowed_commands工具。

示例10：自定义允许命令

运行服务器时指定允许的命令：

node dist/index.js dir echo npm git

六、安全配置

默认允许的命令

默认情况下，只允许安全的命令：

• 系统信息检索
• 网络配置查询
• 进程管理
• 开发工具交互

被阻止的操作

危险命令总是被阻止，包括：

• 磁盘格式化
• 用户管理
• 系统关机
• 关键注册表修改

运行模式

# 默认安全模式
node dist/index.js

# 指定允许的命令
node dist/index.js dir echo npm git

# 扩展模式（谨慎使用）
node dist/index.js --allow-all

七、常见问题

问题1：命令被阻止

解决方案：该命令不在白名单中。使用list_allowed_commands查看允许的命令，或自定义允许列表。

问题2：项目创建失败

解决方案：确保~/AIProjects目录存在且有写入权限。

问题3：PowerShell执行策略限制

解决方案：可能需要调整PowerShell执行策略。

问题4：Node.js版本要求

解决方案：需要Node.js 16或更高版本。

问题5：扩展模式风险

解决方案：--allow-all模式会降低安全性，仅在受信任环境使用。

八、总结

Windows命令行MCP服务器是一个注重安全的Windows系统交互工具，让AI能够安全地执行命令行操作、管理系统和创建项目。

这个项目的最大价值在于：

1. 安全第一：命令白名单、输入验证等多层防护
2. 功能全面：覆盖命令执行、PowerShell、进程、服务、网络等
3. 开发友好：支持React、Node.js、Python项目创建
4. 灵活配置：支持自定义允许命令列表
5. MIT许可证：可自由使用和修改

如果你是Windows用户，并且希望用AI来辅助系统管理和开发，Windows命令行MCP服务器是一个安全可靠的选择。