AI导哈

Windows命令行MCP服务器

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

  • by alxspiker
  • TypeScript
  • 本地部署
  • 10 星标
  • 更新于
在 GitHub 查看 alxspiker/Windows-Command-Line-MCP-Server

使用说明

Windows命令行MCP服务器

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

概述

Windows命令行MCP服务器在AI模型和Windows系统操作之间提供了一个强大、安全的桥梁。它允许受控执行命令、创建项目和检索系统信息，同时保持严格的安全协议。

主要特点

🔒 增强的安全性

  • 全面指挥
  • 严格的输入验证
  • 防止破坏性系统操作
  • 可配置的安全级别

🛠 开发工具支持

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

🖥 系统交互能力

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

安装

通过Smithery安装

通过以下方式自动安装Windows命令行MCP Server for Claude Desktop 史密瑟里:

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

先决条件

  • Node.js 16或更高版本
  • npm或纱线
  • 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_命令：运行Windows CLI命令
  2. execute_powershell：执行PowerShell脚本
  3. 创建项目：安全地创建新的开发项目
  4. list_running_processs：检索活动系统进程
  5. get_system_info：收集系统配置详细信息
  6. get_network_info：检索网络适配器信息
  7. get_scheduled_tasks：列出和查询系统任务
  8. get_service_info：管理和查询Windows服务
  9. list_allowed_命令：列出服务器可以执行的所有命令

使用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 通往建筑的绝对路径 index.js 文件在 dist 目录。

  1. 重新启动桌面版的Claude
  2. 现在，您可以通过要求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. 分叉存储库
  2. 创建功能分支(git checkout -b feature/amazing-feature)
  3. 提交您的更改(git commit -m 'Add some amazing feature')
  4. 推到分支(git push origin feature/amazing-feature)
  5. 打开拉取请求

许可证

此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。

致谢

  • 受模型上下文协议规范的启发
  • 考虑到安全性和灵活性而开发

版本历史记录

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

支持

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

相关 MCP