SuperAPI AI 工具集

linux-mcp

linux-mcp 是一个基于 Model Context Protocol(MCP)的 Linux 系统监控服务器,通过 STDIO 传输提供实时系统信息。它覆盖系统、CPU、内存、磁盘、网络、进程、Docker、systemd 服务、安全审计、软件包、硬件、桌面会话、存储健康、系统健康、/proc 诊断、man 手册以及快照等类别,共 65 个工具和 19 个资源。该服务器为只读设计,不修改系统状态。安装方式包括从 MCP Registry 发现并安装、从 GitHub Releases 下载预编译二进制文件,或使用 Go 1.27+ 从源码构建。运行需要 Linux 环境,Docker 工具为可选依赖。

访问官网

工具介绍

linux-mcp 是一个 Linux 系统监控 MCP 服务器,基于 Model Context Protocol(MCP)构建,通过 STDIO 传输提供实时系统信息。该服务器为只读设计,不修改系统状态。

用途 linux-mcp 旨在让 MCP 客户端(如 Claude Desktop、Claude Code、Codex、OpenCode 或任何 MCP 主机)能够查询 Linux 系统的实时状态。它通过 MCP 工具和资源暴露系统数据,适合需要将系统监控能力集成到 AI 助手或自动化流程中的场景。

主要能力 服务器提供 65 个工具和 19 个资源,覆盖以下类别:

  • 系统:主机名、操作系统、内核、架构、运行时间、负载平均值
  • CPU:使用率、型号、频率、核心数、温度传感器
  • 内存:RAM 和交换分区使用情况及百分比
  • 磁盘:各分区使用情况、inode、挂载选项、最大文件、块设备
  • 网络:接口统计、活动连接、监听端口、DNS、ping、IP 地理位置与 ASN 查询
  • 进程:按 CPU 或内存排序的运行进程、每个进程的打开文件描述符
  • Docker:容器、镜像、网络、卷、磁盘使用、系统信息及容器统计
  • 服务与自动化:systemd 单元、服务状态、用户定时器、crontab、系统 cron 任务
  • 安全:活动用户会话、失败登录检测、SELinux/AppArmor 状态、防火墙/SSH/SUID/全局可写审计及安全评分
  • 软件包:已安装软件包和可用更新(pacman、dpkg、rpm/dnf、apk)
  • 硬件:GPU 信息、PCI/USB 总线设备、电源/电池分析
  • 桌面会话:Wayland/X11 协议、桌面环境标识、运行时配置
  • 存储健康:RAID 状态、logrotate 配置、时间同步、SMART 磁盘健康、每设备 I/O 指标
  • 系统健康:综合健康评估,包含内存、磁盘、负载和 systemd 检查
  • /proc 诊断:深度 /proc 检查,包括中断、软中断、vmstat、diskstats、文件系统、内核版本、slabinfo
  • man 手册:任何已安装命令的系统手册页
  • 快照:单次调用获取综合系统概览
  • MCP 资源:系统数据也可作为可读资源访问

使用方式 服务器通过 STDIO 传输通信,遵循 MCP 标准,设计为由 MCP 客户端启动。

安装选项:

  1. 通过 MCP Registry:在 MCP Registry 上发现该服务器,并通过 MCP 客户端安装(VS Code 一键安装或手动配置)。
  2. 下载预编译二进制文件:从 GitHub Releases 页面下载最新二进制文件。还提供完全静态构建(无 libc 依赖)的 linux-mcp_static。二进制文件放置在 $GOPATH/bin/(通常为 ~/go/bin/)。
  3. 从源码构建:需要 Go 1.27+。二进制文件放置在 bin/linux-mcp。如需完全静态二进制(无 libc 依赖),也可构建。

运行要求:

  • Linux(服务器面向 Linux;部分工具使用 Linux 特定路径)
  • Go 1.27+(仅从源码构建时需要)
  • Docker(可选,仅 Docker 工具需要)

直接运行:启动服务器并在 STDIN/STDOUT 上监听 MCP 请求。

客户端配置示例:

  • OpenCode:将服务器配置添加到 OpenCode 配置中,或通过 CLI 添加。可限定到所有项目而非仅当前项目。
  • Claude Code:在项目根目录创建 .mcp.json 文件用于团队共享配置,或在 Claude Code 会话中使用 /mcp 验证连接。
  • Codex:手动添加到 ~/.codex/config.toml(或项目范围的 .codex/config.toml),使用 codex mcp list 验证连接。

配置: 服务器可通过从 ~/.config/linux-mcp/config.json 或 LINUX_MCP_CONFIG 环境变量加载的 JSON 文件进行配置。服务器还处理 SIGHUP,以在运行时重新加载配置文件而无需重启。

适用场景

  • 将 Linux 系统监控集成到 AI 助手或 MCP 客户端中
  • 通过自然语言查询系统状态、进程、网络、Docker 容器等信息
  • 安全审计与系统健康检查
  • 开发或运维场景中快速获取系统快照

限制

  • 服务器为只读设计,不修改系统状态
  • 面向 Linux 系统,部分工具依赖 Linux 特定路径
  • Docker 工具需要 Docker 环境
  • 从源码构建需要 Go 1.27+
  • 该服务器已发布在 MCP Registry 上,标识为 io.github.Mohabdo21/linux-mcp

依赖与致谢

  • modelcontextprotocol/go-sdk - Go 的 MCP SDK
  • shirou/gopsutil/v4 - 系统指标(CPU、内存、磁盘、网络、进程、传感器)
  • docker/go-sdk - Docker Engine API 客户端
  • moby/moby/client - Docker 客户端库
  • ip-api.com - 免费 IP 地理位置 API(用于 get_ip_info)