项目简介

Windows命令行MCP服务器是一个基于Model Context Protocol (MCP) 构建的后端服务，旨在为AI模型（如 Claude）提供安全且高效的Windows系统交互能力。它允许AI模型通过预定义的工具安全地执行Windows命令行操作，例如检索系统信息、管理进程、以及进行简单的开发项目创建。该服务器注重安全性，内置命令白名单和输入验证机制，防止恶意操作，为AI应用提供可信赖的系统级上下文服务。

主要功能点

安全命令执行: 允许AI模型执行预定义的Windows命令行和PowerShell命令，所有命令都经过安全检查，防止潜在的破坏性操作。
系统信息获取: 提供多种工具用于获取Windows系统的详细信息，包括操作系统、硬件配置、网络信息、运行进程、计划任务和服务状态。
开发工具支持: 支持创建React、Node.js和Python项目，为AI驱动的开发流程提供基础能力。
灵活配置: 可以通过命令行参数自定义允许执行的命令列表，满足不同安全级别的需求。
易于集成: 通过标准的MCP协议和JSON-RPC通信，可以方便地与各种支持MCP协议的AI客户端集成，例如 Claude Desktop。

安装步骤

环境准备:
- 确保已安装 Node.js 16 或更高版本。
- 确保已安装 npm 或 yarn 包管理器。
- 操作系统为 Windows。

下载仓库代码:

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

安装依赖并构建:
```
npm install
npm run build
```
构建成功后，会在 'dist' 目录下生成服务器程序 'index.js'。

服务器配置

要让MCP客户端（例如 Claude Desktop）连接到此服务器，需要在客户端的配置文件中添加服务器信息。以 'claude_desktop_config.json' 为例，配置信息如下：

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

server name: 'windows-cmd' (服务器名称，客户端用此名称引用)
command: 'node' (启动服务器的命令，这里使用 Node.js 运行时)
args: '["/path/to/dist/index.js"]' (启动参数，指向构建后的服务器程序 'index.js' 的绝对路径。请将 '/path/to/dist/index.js' 替换为实际路径)

注意: 请将 '/path/to/dist/index.js' 替换为 'dist/index.js' 文件在您本地文件系统中的绝对路径。您可以通过在终端中进入 'Windows-Command-Line-MCP-Server' 目录，然后执行 'pwd' (macOS/Linux) 或 'Get-Location' (PowerShell) 命令来获取当前目录的绝对路径，再拼接上 'dist/index.js'。

基本使用方法

启动服务器: 按照上述 “服务器配置” 中的配置，客户端在启动时会自动启动该MCP服务器。或者，您也可以在终端中手动运行服务器：
```
node dist/index.js
```
在AI客户端中使用工具: 当服务器成功运行并连接到MCP客户端后，您可以通过自然语言指示AI模型使用服务器提供的工具。例如，在 Claude 中，您可以提问：
- "列出当前运行的进程" (对应 'list_running_processes' 工具)
- "获取系统信息" (对应 'get_system_info' 工具)
- "查看网络配置" (对应 'get_network_info' 工具)
AI模型会根据您的指令，调用相应的 MCP 工具并返回结果。您可以通过 'list_allowed_commands' 工具查看服务器支持的所有命令和工具。

安全性提示: 默认配置下，服务器已启用安全模式，只允许执行安全的命令。如果您需要扩展命令范围，请谨慎操作，并参考仓库文档了解 '--allow-all' 等选项的使用方法和安全风险。

关键词

项目简介

主要功能点

安装步骤

服务器配置

基本使用方法

信息