系统信息 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.jsClaude 桌面集成
要在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)的环境变量将被自动过滤
- 排除进程命令行参数以防止秘密泄露
- 不向外部发送任何数据——所有信息均保持本地化
故障排除
服务器无法启动
- 确保你已经构建了项目:
npm run build - 检查 Node.js 版本:
node --version(应为18岁以上) - 检查 stderr 输出中的错误
工具返回“不可用”错误
某些工具需要:
- 提升权限(管理员/root)
- 特定硬件(电池、WiFi适配器等)
- 平台支持(某些功能特定于操作系统)
Claude Desktop 无法看到服务器
- 验证路径中的内容
claude_desktop_config.json是正确的 - 确保路径使用正斜杠(/)或转义后的反斜杠(\\\\)
- 配置更改后重启Claude桌面版
许可证
麻省理工学院(MIT)
版本
1.0.0
