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 客户端启动。
安装选项:
- 通过 MCP Registry:在 MCP Registry 上发现该服务器,并通过 MCP 客户端安装(VS Code 一键安装或手动配置)。
- 下载预编译二进制文件:从 GitHub Releases 页面下载最新二进制文件。还提供完全静态构建(无 libc 依赖)的 linux-mcp_static。二进制文件放置在 $GOPATH/bin/(通常为 ~/go/bin/)。
- 从源码构建:需要 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)