Windows Command Line MCP Server

🚀 Windows命令行MCP服务器

Windows命令行MCP服务器是一个安全的模型上下文协议（MCP）服务器，它能让AI模型与Windows命令行功能进行安全且高效的交互，为AI在Windows系统中的应用搭建了可靠桥梁。

🚀 快速开始

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

✨ 主要特性

🔒 增强安全性

• 具备全面的命令允许列表，严格限制可执行命令。
• 对输入进行严格验证，从源头防止不安全操作。
• 有效防止破坏性系统操作，保障系统稳定。
• 支持可配置的安全级别，满足不同场景需求。

🛠 开发工具支持

• 支持创建React、Node.js和Python项目，助力开发工作。
• 提供安全的开发环境交互，让开发过程更安心。
• 具备扩展的命令支持，适配多样化的开发工作流程。

🖥 系统交互能力

• 可执行Windows CLI命令，实现常规系统操作。
• 能够运行PowerShell脚本，处理复杂任务。
• 可以获取系统和网络信息，方便进行系统监控。
• 支持管理进程和服务，保障系统资源合理利用。

📦 安装指南

通过Smithery安装

使用Smithery自动安装Windows命令行MCP服务器以备Claude Desktop：

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。
• 在受sandbox保护的%USERPROFILE%\Documents\wcl-mcp-server\projects目录中创建项目。

可用工具

1. 系统信息查询：获取详细的系统信息，包括硬件和软件配置。
2. 网络信息检索：列出所有网络接口的状态、IP地址和连接信息。
3. 进程管理：查看当前运行的进程并支持终止指定进程。
4. 服务管理：列出所有正在运行的服务及其详细状态，并支持停止特定服务。

与Claude for Desktop集成

为了在Claude Desktop中使用该服务器，请将以下内容添加到config.json文件中：

{
    "windowsCommandLineMcp": {
        "enabled": true,
        "port": 3000,
        "path": "%USERPROFILE%/Documents/wcl-mcp-server"
    }
}

🔧 技术细节

安全考虑

• 允许的操作：执行预定义的命令、创建和管理项目、查询系统和网络信息。
• 禁止的操作：直接访问文件系统、执行任意代码或进行其他高风险操作。

配置

通过以下命令行选项自定义服务器行为：

# 启动服务器并指定配置文件
npm run start -- --config ./config.json

# 以调试模式运行
npm run debug

🤝 贡献指南

• 问题：报告错误或提出功能请求。
• 代码贡献：提交修复或新功能的拉取请求。
• 文档改进：更新或扩展项目文档。

📄 许可证

项目遵循MIT许可证，具体内容请参阅LICENSE文件。

📜 版本历史

• 0.3.0
  • 新增网络信息检索功能。
  • 改进服务管理模块。
• 0.2.0
  • 新增项目创建功能。
  • 扩展开发工具支持。
• 0.1.0
  • 初始版本，提供基本命令执行能力。

🆘 支持

如需帮助、有疑问或建议，请在GitHub问题中提交。