windows系统mcp服务器

Name: windows系统mcp服务器
Author: guangxiangdebizi

作者：guangxiangdebizi2 星标更新：2025-07-29

安装使用来源：spider==github.com

项目介绍

🖥️ Windows系统MCP

一个全面的模型上下文协议（MCP）服务器，提供强大的Windows系统管理能力给AI模型。此MCP允许AI助手通过安全、结构良好的接口与Windows系统交互。

✨ 特性

📁 文件系统管理

目录浏览：导航和探索目录结构
文件操作：读取文件，获取文件信息，搜索文件
磁盘分析：监控磁盘使用情况，查找大文件
高级搜索：基于模式的递归文件搜索

⚙️ 进程管理

进程监控：列出并监控运行中的进程
资源跟踪：追踪进程的CPU和内存使用情况
进程控制：启动、停止和管理进程
进程树：可视化父进程和子进程的关系

🔧 系统信息

硬件详情：CPU、内存、磁盘和网络适配器的信息
操作系统信息：Windows版本、更新和系统配置
环境：环境变量和系统路径
用户管理：用户账户和当前用户信息

📋 注册表操作

注册表读取：访问Windows注册表键值
系统配置：从注册表中检索系统设置
启动程序：列出随Windows启动的程序
已安装软件：枚举已安装的应用程序

🛠️ 服务管理

服务控制：启动、停止和重启Windows服务
服务监控：监控服务状态和依赖关系
自动启动服务：管理自动启动的服务
服务搜索：按名称或描述查找服务

🌐 网络操作

网络诊断：Ping、Traceroute和连接测试
端口扫描：检查开放端口和网络连接
网络配置：查看适配器、IP配置和路由
WiFi管理：列出和管理WiFi配置文件

📊 性能监控

实时指标：CPU、内存、磁盘和网络性能
资源分析：识别消耗资源最多的进程
性能计数器：访问Windows性能计数器
系统健康：监控整体系统性能

📥 安装

# 全局安装（推荐）
npm install -g windows-system-mcp

# 或直接使用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 dev

SSE部署（Supergateway）

如果全局安装：

npx supergateway --stdio "windows-system-mcp" --port 3100

如果从源码构建：

npm run sse

这将在http://localhost:3100/sse启动服务器。

🔧 配置

Claude桌面集成

Stdio配置

如果全局安装：

{
  "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模式，请先使用上面部署部分所示的命令启动服务器。

📖 使用示例

文件系统操作

// 列出目录内容
{
  "action": "list_directory",
  "path": "C:\\Users",
  "recursive": true,
  "max_depth": 2
}

// 搜索文件
{
  "action": "search_files",
  "pattern": "*.log",
  "path": "C:\\Windows\\Logs",
  "recursive": true
}

// 查找大文件
{
  "action": "find_large_files",
  "path": "C:\\",
  "size_threshold": 500
}

进程管理

// 列出运行中的进程
{
  "action": "list_processes",
  "sort_by": "cpu",
  "limit": 20
}

// 获取进程详情
{
  "action": "get_process_details",
  "process_name": "chrome"
}

// 杀死进程
{
  "action": "kill_process",
  "process_id": 1234
}

系统信息

// 获取系统概览
{
  "action": "get_system_overview"
}

// 获取硬件信息
{
  "action": "get_hardware_info",
  "category": "cpu"
}

// 获取环境变量
{
  "action": "get_environment_vars",
  "filter": "PATH"
}

网络操作

// Ping主机
{
  "action": "ping_host",
  "host": "google.com",
  "count": 4
}

// 扫描端口
{
  "action": "scan_open_ports",
  "host": "localhost",
  "port_range": "80,443,3000-3010"
}

// 获取网络适配器
{
  "action": "get_network_adapters"
}

🛡️ 安全注意事项

最小权限原则：以最低权限运行
输入验证：所有输入都经过验证和清理
安全操作：优先考虑只读操作
错误处理：全面的错误处理防止系统暴露
审计跟踪：所有操作都可以记录用于安全审计

🤝 贡献

我们欢迎贡献！请参阅我们的贡献指南了解详情。

开发设置

分叉仓库
创建特性分支：git checkout -b feature/amazing-feature
进行更改
如适用添加测试
提交更改：git commit -m '添加惊人的功能'
推送到分支：git push origin feature/amazing-feature
打开拉取请求

📄 许可证

本项目根据Apache许可证2.0发布 - 详情见LICENSE文件。

🔗 链接

NPM包：https://www.npmjs.com/package/windows-system-mcp
GitHub：https://github.com/guangxiangdebizi/windows-system-mcp
作者：陈兴宇
邮箱：guangxiangdebizi@gmail.com
NPM个人资料：https://www.npmjs.com/~xingyuchen

👨‍💻 作者

陈兴宇

🌐 网站：GitHub主页
📧 邮箱：guangxiangdebizi@gmail.com
💼 LinkedIn：陈兴宇
📦 NPM：@xingyuchen

🙏 致谢

模型上下文协议提供了优秀的MCP框架
Windows PowerShell团队提供了强大的系统管理能力
TypeScript和Node.js社区提供了优秀的工具

📊 项目统计

NPM包：可用名为windows-system-mcp
语言：TypeScript
运行时：Node.js
平台：Windows
许可证：Apache 2.0
MCP版本：0.6.0

<div align="center"> <strong>为AI和Windows社区打造，充满爱心</strong> </div>