🖥️ Windows系统MCP
](https://www.npmjs.com/package/windows-system-mcp) ](https://www.npmjs.com/package/windows-system-mcp)   ](https://nodejs.org/)
一个全面的模型上下文协议（MCP）服务器，为AI模型提供强大的Windows系统管理功能。此MCP使AI助手能够通过安全、结构良好的界面与Windows系统进行交互。
✨ 特性
📁 文件系统管理
- 目录浏览：导航和探索目录结构
- 文件操作：读取文件、获取文件信息和搜索文件
- 磁盘分析：监视磁盘使用情况并查找大文件
- 高级搜索：使用递归选项进行基于模式的文件搜索
⚙️ 流程管理
- 过程监控：列出并监控正在运行的进程
- 资源跟踪：按进程跟踪CPU和内存使用情况
- 过程控制：启动、停止和管理流程
- 进程树：可视化父子流程关系
🔧 系统信息
- 硬件详细信息：CPU、内存、磁盘和网络适配器信息
- 操作系统信息：Windows版本、更新和系统配置
- 环境：环境变量和系统路径
- 用户管理：用户帐户和当前用户信息
📋 注册表操作
- 注册表读取：访问Windows注册表项和值
- 系统配置：从注册表检索系统设置
- 启动程序：列出以Windows开头的程序
- 已安装的软件：枚举已安装的应用程序
🛠️ 服务管理
- 服务控制：启动、停止和重新启动Windows服务
- 服务监控：监视服务状态和依赖关系
- 启动服务：管理自动启动的服务
- 服务搜索：按名称或描述查找服务
🌐 网络运营
- 网络诊断：Ping、跟踪路由和连接测试
- 端口扫描：检查打开的端口和网络连接
- 网络配置：查看适配器、IP配置和路由
- WiFi管理：列出和管理WiFi配置文件
📊 性能监控
- 实时度量：CPU、内存、磁盘和网络性能
- 资源分析：确定最消耗资源的流程
- 性能计数器：访问Windows性能计数器
- 系统健康：监控整体系统性能
📥 安装
# Global installation (recommended)
npm install -g windows-system-mcp
# Or use directly with npx
npx windows-system-mcp🚀 快速开始
先决条件
- Windows 10/11
- Node.js 18+
- PowerShell 5.1+
安装选项
选项1：从NPM安装（推荐）
npm install -g windows-system-mcp选项2：从源代码构建
- 克隆存储库：
git clone https://github.com/guangxiangdebizi/windows-system-mcp.git
cd windows-system-mcp- 安装依赖项：
npm install- 构建项目：
npm run build地方发展（Stdio）
如果全局安装：
windows-system-mcp如果从源代码构建：
npm start发展
对于自动重建的开发：
npm run devSSE部署（超级网关）
如果全局安装：
npx supergateway --stdio "windows-system-mcp" --port 3100如果从源代码构建：
npm run sse这将启动服务器 http://localhost:3100/sse
🔧 配置
Claude桌面集成
标准配置
如果全局安装：
{
"mcpServers": {
"windows-system-mcp": {
"command": "windows-system-mcp"
}
}
}如果从源代码构建：
{
"mcpServers": {
"windows-system-mcp": {
"command": "node",
"args": ["path/to/windows-system-mcp/build/index.js"]
}
}
}SSE配置
{
"mcpServers": {
"windows-system-mcp": {
"type": "sse",
"url": "http://localhost:3100/sse",
"timeout": 600
}
}
}备注：对于SSE模式，首先使用上面部署部分中显示的命令启动服务器。
📖 使用示例
文件系统操作
// List directory contents
{
"action": "list_directory",
"path": "C:\\Users",
"recursive": true,
"max_depth": 2
}
// Search for files
{
"action": "search_files",
"pattern": "*.log",
"path": "C:\\Windows\\Logs",
"recursive": true
}
// Find large files
{
"action": "find_large_files",
"path": "C:\\",
"size_threshold": 500
}流程管理
// List running processes
{
"action": "list_processes",
"sort_by": "cpu",
"limit": 20
}
// Get process details
{
"action": "get_process_details",
"process_name": "chrome"
}
// Kill a process
{
"action": "kill_process",
"process_id": 1234
}系统信息
// Get system overview
{
"action": "get_system_overview"
}
// Get hardware information
{
"action": "get_hardware_info",
"category": "cpu"
}
// Get environment variables
{
"action": "get_environment_vars",
"filter": "PATH"
}网络运营
// Ping a host
{
"action": "ping_host",
"host": "google.com",
"count": 4
}
// Scan ports
{
"action": "scan_open_ports",
"host": "localhost",
"port_range": "80,443,3000-3010"
}
// Get network adapters
{
"action": "get_network_adapters"
}🛡️ 安全考虑
- 最小特权原则：以所需的最小权限运行
- 输入验证：所有输入都经过验证和消毒
- 安全操作：只读操作具有优先级
- 错误处理：全面的错误处理可防止系统暴露
- 审计跟踪：可以记录所有操作以进行安全审计
🤝 贡献
我们欢迎捐款！请查看我们的 贡献指南 了解详情。
开发设置
- 分叉存储库
- 创建要素分支：
git checkout -b feature/amazing-feature - 进行更改
- 如果适用，添加测试
- 提交您的更改：
git commit -m 'Add amazing feature' - 推到分支：
git push origin feature/amazing-feature - 打开拉取请求
📄 许可证
此项目根据Apache许可证2.0获得许可-请参阅 许可证 文件以获取详细信息。
🔗 链接
- NPM包:
- GitHub:
- 作者: 陈兴宇
- 电子邮件: guangxiangdebizi@gmail.com
- NPM简介:
👨💻 作者
陈兴宇
🙏 致谢
- 模型上下文协议 优秀的MCP框架
- Windows PowerShell团队提供强大的系统管理功能
- TypeScript和Node.js社区提供优秀的工具
📊 项目统计
- NPM包：可用
windows-system-mcp - 语言：TypeScript
- 运行时：Node.js
- 平台：Windows
- 许可证：Apache 2.0
- MCP版本: 0.6.0
______________________________________________________________________
Built with ❤️ for the AI and Windows communities