JinDaGe - Windows Command Line MCP Server MCP Details

article

README

🚀 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问题中提交。

Windows Command Line MCP Server