内容
# 系统监视器 MCP 服务器适用于 Linux
适用于 AI 代理以监视和与 Linux 系统交互的模型上下文协议（MCP）服务器实现。此服务器通过 Stdio 和安全的 HTTP/SSE 传输提供包括 CPU、内存、磁盘、网络和进程数据在内的综合指标。
<!-- NPM-VERSION-START -->
[](https://www.npmjs.com/package/@darkphilosophy/system-monitor)  
<!-- NPM-VERSION-END -->
## 功能特点
- **双模式**：作为标准 MCP 服务器（Stdio）或安全 HTTP 服务器（`--http`）运行。
- **性能优化**：使用 TTL 缓存静态硬件信息和并行传感器轮询。
- **系统信息**：主机名、操作系统详细信息、内核版本、运行时间。
- **CPU 监控**：使用率、频率、核心数、品牌和温度。
- **内存监控**：RAM 和交换内存使用率，实时可用性。
- **磁盘监控**：存储使用率、文件系统类型和挂载点过滤。
- **网络监控**：接口统计、流量数据和错误跟踪。
- **持久指标**：后台持久化到 `history.json`，滚动 24 小时窗口。
- **主动警报**：实时阈值监控（CPU、内存、磁盘、温度），立即控制台警告。
- **高级进程跟踪**：按资源消耗筛选、排序和限制进程列表。
## 安全
### HTTP 身份验证
在 HTTP 模式下运行（`--http`）时，可以使用 API 密钥保护端点。
1. 设置 `MCP_API_KEY` 环境变量：
```bash
export MCP_API_KEY="your-secure-token-here"
node src/index.js --http
```
2. 客户端必须在 `x-api-key` 头部或作为查询参数提供密钥：
- **头部**：`x-api-key: your-secure-token-here`
- **查询**：`http://localhost:57996/sse?apiKey=your-secure-token-here`
*注意：如果未设置 `MCP_API_KEY`，HTTP 服务器将默认为公共访问（仅限本地网络）。*
## 安装
### 自动安装（推荐）
此脚本安装到 `~/.gemini/extensions/system-monitor-js`，运行 `npm install`，并在 `~/.local/share/mcp-servers/system-monitor-js` 处创建传统符号链接。
```bash
curl -fsSL https://raw.githubusercontent.com/DarkPhilosophy/mcp-system-monitor-js/master/install.sh | bash
```
### 手动安装
1. **克隆仓库：**
```bash
git clone https://github.com/DarkPhilosophy/mcp-system-monitor-js.git
cd mcp-system-monitor-js
```
2. **安装依赖项（手动安装所需）：**
```bash
npm install
```
3. **链接到 Gemini 扩展和传统 MCP 路径（可选）：**
```bash
mkdir -p ~/.gemini/extensions
ln -s $(pwd) ~/.gemini/extensions/system-monitor-js
ln -sfn ~/.gemini/extensions/system-monitor-js ~/.local/share/mcp-servers/system-monitor-js
```
## 使用
### MCP 模式（默认 / Stdio）
适用于 Claude Desktop 或 OpenCode 等 MCP 兼容客户端。
```bash
node src/index.js
```
**OpenCode 配置（`~/.config/opencode/opencode.json`）：**
```json
"system-monitor": {
"type": "local",
"command": [
"node",
"/var/home/alexa/.gemini/extensions/system-monitor-js/src/index.js"
],
"enabled": true
}
```
### HTTP 服务器模式
```bash
node src/index.js --http
```
服务器默认监听 **57996** 端口。
## 工具
- `get_system_info`：一般操作系统/内核详细信息。
- `get_cpu_info`：负载、规格和温度。
- `get_memory_info`：RAM/交换内存指标。
- `get_disk_info`：分区使用情况。参数：`mountPoint`（可选）。
- `get_network_info`：流量和接口统计。
- `get_processes`：活动进程。参数：`limit`（数字），`name`（筛选），`sortBy`（`cpu_usage`、`memory_usage`、`priority`）。
- `get_system_metrics`：综合系统健康状况快照。
- `get_metrics_history`：检索历史性能趋势。参数：`limit`（分钟数）。
- `get_battery_info`：电源状态和电池健康状况。
- `get_usb_devices`：连接的硬件列表。
## 验证状态
<!-- LINT-RESULT-START -->
### 校验状态
> **状态**：✅ **通过**
> **最后更新**：2026-01-25 12:03:39 UTC
> **摘要**：0 个错误，0 个警告
<!-- LINT-RESULT-END -->
<!-- LATEST-VERSION-START -->
<details open>
<summary><strong>最新更新（v0.2.1）</strong></summary>
- 2026-01-25
- **二进制入口点**：添加 npm CLI 入口点 `mcp-system-monitor`。
</details>
<!-- LATEST-VERSION-END -->
