STARWARCLOUD STARWAR.AI
返回市场
windows系统mcp服务器

windows系统mcp服务器

作者：guangxiangdebizi2 星标更新：2025-07-29
安装使用来源：spider==github.com

项目介绍

🖥️ Windows系统MCP

NPM版本 NPM下载量 许可证 TypeScript Node.js

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

  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部署（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"
}

🛡️ 安全注意事项

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

🤝 贡献

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

开发设置

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

📄 许可证

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

🔗 链接

👨‍💻 作者

陈兴宇

🙏 致谢

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