AI导哈

Windows系统管理协议

一个全面的模型上下文协议（MCP）服务器，为AI模型提供强大的Windows系统管理功能，通过安全、结构化的接口实现与Windows系统的交互。

  • by guangxiangdebizi
  • TypeScript
  • 本地部署
  • 6 星标
  • 更新于
在 GitHub 查看 guangxiangdebizi/windows-system-mcp

使用说明

🖥️ Windows系统MCP

一个全面的模型上下文协议（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：从源代码构建

  1. 克隆存储库：

    git clone https://github.com/guangxiangdebizi/windows-system-mcp.git
cd windows-system-mcp

  2. 安装依赖项：

    npm install

  3. 构建项目：

    npm run build

地方发展（Stdio）

如果全局安装：

windows-system-mcp

如果从源代码构建：

npm start

发展

对于自动重建的开发：

npm run dev

SSE部署（超级网关）

如果全局安装：

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"
}

🛡️ 安全考虑

  • 最小特权原则：以所需的最小权限运行
  • 输入验证：所有输入都经过验证和消毒
  • 安全操作：只读操作具有优先级
  • 错误处理：全面的错误处理可防止系统暴露
  • 审计跟踪：可以记录所有操作以进行安全审计

🤝 贡献

我们欢迎捐款！请查看我们的 贡献指南 了解详情。

开发设置

  1. 分叉存储库
  2. 创建要素分支： git checkout -b feature/amazing-feature
  3. 进行更改
  4. 如果适用，添加测试
  5. 提交您的更改： git commit -m 'Add amazing feature'
  6. 推到分支： git push origin feature/amazing-feature
  7. 打开拉取请求

📄 许可证

此项目根据Apache许可证2.0获得许可-请参阅 许可证 文件以获取详细信息。

🔗 链接

👨‍💻 作者

陈兴宇

🙏 致谢

  • 模型上下文协议 优秀的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

相关 MCP