AI导哈

系统信息监控服务器

一个全面的模型上下文协议（MCP）服务器，用于系统信息监控和诊断，提供18种工具来获取CPU、内存、磁盘、网络、进程、电池、硬件等详细信息。

  • by srirama7
  • JavaScript
  • 本地部署
  • 更新于
在 GitHub 查看 srirama7/system-info-mcp

使用说明

系统信息 MCP 服务器

一个全面的模型上下文协议（MCP）服务器，用于系统信息、监控和诊断。该服务器提供18种工具，用于检索有关CPU、内存、磁盘、网络、进程、电池、硬件等的详细信息。

特点/功能

  • CPU信息获取CPU型号、核心数、速度、架构和使用情况
  • 内存信息获取RAM和交换内存的统计数据
  • 操作系统获取操作系统详细信息、版本、主机名和运行时间
  • 磁盘信息查看所有已挂载驱动器的磁盘使用情况
  • 网络信息列出带有IP地址和状态的网络接口
  • 流程管理列出正在运行的进程和系统负载
  • 电池状态检查电池电量、充电状态以及健康状况（针对笔记本电脑）
  • 硬件详情获取显卡、显示器和外设信息
  • 温度监测监控CPU和GPU的温度
  • 网络扫描扫描WiFi网络和蓝牙设备
  • 港口信息列出开放的网络端口

安装

先决条件

  • Node.js 18 或更高版本
  • npm 或 yarn

安装依赖项

npm install

构建项目

npm run build

使用方法

运行服务器

该服务器运行在stdio传输层上，设计为与MCP兼容的客户端（如Claude Desktop）一起使用。

node dist/index.js

Claude 桌面集成

要在Claude Desktop中使用此MCP服务器，请将其添加到您的Claude Desktop配置中：

Windows: %APPDATA%\Claude\claude_desktop_config.json macOS（苹果电脑操作系统）： ~/Library/Application Support/Claude/claude_desktop_config.json Linux： ~/.config/Claude/claude_desktop_config.json

添加以下配置：

{
  "mcpServers": {
    "system-info": {
      "command": "node",
      "args": ["C:/Users/amogh/Downloads/mcp/dist/index.js"]
    }
  }
}

注将路径替换为您的实际路径 dist/index.js 文件。

可用工具

工具 描述
get_cpu_info CPU信息，包括核心数、型号、速度和使用率
get_memory_info RAM和交换内存统计信息
get_os_info 操作系统详细信息和版本
get_uptime 系统运行时间信息
get_disk_info 所有已挂载驱动器的磁盘使用情况
get_network_info 网络接口信息
get_system_identity 主机名、用户名和目录路径
get_process_info 当前进程和系统总进程
list_processes 列出运行中的进程及其CPU/内存使用情况
get_system_load 系统负载平均值
get_battery_info 电池状态和健康状况（笔记本电脑）
get_hardware_info 图形、显示器和外设
get_environment_info 环境变量（已过滤敏感变量）
check_internet_connectivity 测试互联网连接和延迟
get_open_ports 列出开放的网络端口
get_temperature_info 硬件温度传感器
scan_wifi_networks 扫描可用WiFi网络
get_bluetooth_devices 列出已配对的蓝牙设备

与Claude一起使用的示例

一旦在Claude Desktop中配置好，您就可以向Claude提问，例如：

  • “我现在的CPU使用率是多少？”
  • “我有多少可用的RAM？”
  • “显示CPU使用率最高的前10个进程”
  • “我的电量还剩多少？”
  • “列出所有网络接口”
  • “我的CPU温度是多少？”
  • “扫描WiFi网络”

发展

项目结构

mcp-system-info/
├── src/
│   ├── index.ts           # Main server entry point
│   ├── types/             # TypeScript type definitions
│   ├── tools/             # Tool implementations
│   ├── utils/             # Utility functions
│   └── config/            # Configuration constants
├── dist/                  # Compiled JavaScript
├── package.json
├── tsconfig.json
└── README.md

构建脚本

# Build the project
npm run build

# Watch mode for development
npm run watch

# Run tests
npm test

# Lint code
npm run lint

平台支持

  • Windows全面支持（Windows 10/11）
  • **macOS（中文常称为“苹果电脑操作系统”或直接简称为“苹果系统”）**全面支持（macOS 12+）
  • Linux全面支持（Ubuntu 20.04+，其他发行版）

某些功能在特定平台上可能功能受限：

  • 在Linux系统上进行温度监控效果最佳
  • WiFi/蓝牙扫描可能需要提升权限
  • 某些硬件细节因平台而异

安全

  • 包含敏感关键词（API_KEY、PASSWORD、SECRET、TOKEN）的环境变量将被自动过滤
  • 排除进程命令行参数以防止秘密泄露
  • 不向外部发送任何数据——所有信息均保持本地化

故障排除

服务器无法启动

  1. 确保你已经构建了项目： npm run build
  2. 检查 Node.js 版本： node --version （应为18岁以上）
  3. 检查 stderr 输出中的错误

工具返回“不可用”错误

某些工具需要：

  • 提升权限（管理员/root）
  • 特定硬件（电池、WiFi适配器等）
  • 平台支持（某些功能特定于操作系统）

Claude Desktop 无法看到服务器

  1. 验证路径中的内容 claude_desktop_config.json 是正确的
  2. 确保路径使用正斜杠（/）或转义后的反斜杠（\\）
  3. 配置更改后重启Claude桌面版

许可证

麻省理工学院（MIT）

版本

1.0.0

相关 MCP