Windows Command Line MCP Server

Windows Command Line MCP 服务

一个安全的 Model Context Protocol (MCP) 服务，可让 AI 模型安全、高效地与 Windows 命令行功能交互。

概述

Windows Command Line MCP 服务为 AI 模型与 Windows 系统操作搭建了稳健、安全的桥梁。它支持受控地执行命令、创建项目和检索系统信息，同时严格遵循安全协议。

主要功能

🔒 增强安全性

• 全面的命令允许列表
• 严格的输入验证
• 防止破坏性系统操作
• 可配置的安全级别

🛠 开发工具支持

• 创建 React、Node.js 和 Python 项目
• 安全地与开发环境交互
• 扩展对开发工作流的命令支持

🖥 系统交互能力

• 执行 Windows CLI 命令
• 运行 PowerShell 脚本
• 检索系统和网络信息
• 管理进程和服务

安装

通过 Smithery 安装

要通过 Smithery 自动为 Claude Desktop 安装 Windows Command Line MCP 服务：

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

先决条件

• 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

用法

命令行选项

• 默认模式：使用预定义的安全命令
• --allow-all：以扩展模式运行（需采取额外预防措施）
• 可以将自定义命令列表指定为参数

创建项目

使用内置的项目创建工具安全地创建新项目：

• 支持的项目类型：React、Node.js、Python
• 项目将在沙箱化的 ~/AIProjects 目录中创建

可用工具

1. execute_command：运行 Windows CLI 命令
2. execute_powershell：执行 PowerShell 脚本
3. create_project：安全地创建新的开发项目
4. list_running_processes：检索当前运行的系统进程
5. get_system_info：收集系统配置详情
6. get_network_info：检索网络适配器信息
7. get_scheduled_tasks：列出并查询系统任务
8. get_service_info：管理并查询 Windows 服务
9. list_allowed_commands：列出服务可执行的所有命令

与 Claude for Desktop 配合使用

要将此服务与 Claude for Desktop 配合使用：

1. 按照上述设置说明构建服务
2. 将其添加到 claude_desktop_config.json：

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

将 /path/to/dist/index.js 替换为 dist 目录中已构建的 index.js 文件的绝对路径。

3. 重启 Claude for Desktop
4. 现在可以让 Claude 执行 Windows 系统操作来使用这些工具

安全注意事项

允许的命令

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

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

禁止的操作

始终禁止危险命令，包括：

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

配置

通过指定允许的命令或使用配置标志，自定义服务的行为。

示例

# Run with default safe commands
node dist/index.js

# Run with specific allowed commands
node dist/index.js dir echo npm git

# Run in extended mode (use with caution)
node dist/index.js --allow-all

贡献

1. Fork 此仓库
2. 创建功能分支（git checkout -b feature/amazing-feature）
3. 提交更改（git commit -m 'Add some amazing feature'）
4. 推送到该分支（git push origin feature/amazing-feature）
5. 提交 Pull Request

许可证

本项目采用 MIT License 许可，详情请参阅 LICENSE 文件。

致谢

• 灵感源自 Model Context Protocol 规范
• 开发时充分考虑了安全性和灵活性

版本历史

• 0.3.0：实现了 README 中提到的所有工具（系统信息、网络信息、进程管理、服务信息）
• 0.2.0：添加了项目创建功能，扩展了开发工具
• 0.1.0：首次发布，支持基本的命令执行功能

支持

如有问题、疑问或建议，请在 GitHub 上提交 issue。