STARWARCLOUD STARWAR.AI
返回市场
Windows命令行MCP服务器

Windows命令行MCP服务器

作者：alxspiker6 星标更新：2025-04-26
安装使用来源：spider==github.com

项目介绍

MseeP 徽章

Windows 命令行 MCP 服务器

一个安全的模型上下文协议（MCP）服务器，使AI模型能够安全高效地与Windows命令行功能交互。

版本 许可证：MIT smithery 徽章

概述

Windows 命令行 MCP 服务器提供了一个强大的、安全的桥梁，连接AI模型与Windows系统操作。它允许在严格的安全协议下执行受控命令、创建项目以及检索系统信息。

主要特性

🔒 增强安全性

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

🛠 开发工具支持

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

🖥 系统交互能力

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

安装

通过Smithery安装

要通过Smithery自动安装Windows命令行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一起使用

要将此服务器与桌面Claude一起使用：

  1. 使用上述设置说明构建服务器
  2. 将其添加到您的claude_desktop_config.json：
{
  "mcpServers": {
    "windows-cmd": {
      "command": "node",
      "args": ["/path/to/dist/index.js"]
    }
  }
}

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

  1. 重启桌面Claude
  2. 您现在可以通过请求Claude执行Windows系统操作来使用这些工具

安全注意事项

允许的命令

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

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

阻止的操作

危险命令始终被阻止，包括：

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

配置

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

示例

# 使用默认安全命令运行
node dist/index.js

# 使用特定允许的命令运行
node dist/index.js dir echo npm git

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

贡献

  1. 分叉仓库
  2. 创建您的功能分支（git checkout -b feature/amazing-feature）
  3. 提交更改（git commit -m '添加一些惊人的功能'）
  4. 推送到分支（git push origin feature/amazing-feature）
  5. 打开拉取请求

许可证

该项目采用MIT许可证——请参阅LICENSE文件获取详细信息。

致谢

  • 受模型上下文协议规范启发
  • 以安全性和灵活性为设计理念

版本历史

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

支持

对于问题、疑问或建议，请在GitHub上打开一个问题。