🚀 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

贡献指南

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

版本历史

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

支持

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

📄 许可证

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