🚀 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目录中创建项目。
可用工具
- 系统信息查询：获取详细的系统信息，包括硬件和软件配置。
- 网络信息检索：列出所有网络接口的状态、IP地址和连接信息。
- 进程管理：查看当前运行的进程并支持终止指定进程。
- 服务管理：列出所有正在运行的服务及其详细状态，并支持停止特定服务。
与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问题中提交。