Linux Mcp

linux-mcp - Linux MCP 服务

基于 Model Context Protocol (MCP) 构建的 Linux 系统监控服务。通过 STDIO 传输方式提供实时系统信息，包括 CPU、内存、磁盘、网络、进程、Docker 等，并通过 MCP 工具访问。

功能

• 系统 - 主机名、操作系统、内核、架构、运行时间、平均负载
• 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 协议、DE 标识符、运行时配置
• 存储健康状况 - RAID 状态、logrotate 配置、时间同步、SMART 磁盘健康状况、各设备 I/O 指标
• 系统健康状况 - 综合健康评估，包括内存、磁盘、负载和 systemd 检查
• /proc 诊断 - 深入检查 /proc：中断、softirq、vmstat、diskstats、文件系统、内核版本、slabinfo
• 手册页 - 任意已安装命令的系统手册页
• 快照 - 一次调用即可获取全面的系统概览
• MCP 资源 - 系统数据也可作为可读资源访问

前置条件

• Go 1.27+（从源代码构建时需要）
• Linux（此服务面向 Linux；部分工具使用 Linux 专用路径）
• Docker（可选 - 仅 Docker 工具需要）

安装

通过 MCP Registry 安装

在 MCP Registry 中查找此服务，并通过 MCP 客户端安装（VS Code 一键安装，或手动配置）。

下载预构建二进制文件

从 GitHub Releases 页面下载最新二进制文件：

curl -LO https://github.com/Mohabdo21/linux-mcp/releases/latest/download/linux-mcp
chmod +x linux-mcp

另提供完全静态构建版本（不依赖 libc），文件名为 linux-mcp_static。

通过 go install 安装

go install github.com/Mohabdo21/linux-mcp@latest

二进制文件会放置在 $GOPATH/bin/ 中（通常为 ~/go/bin/）。

从源代码构建

git clone https://github.com/Mohabdo21/linux-mcp.git
cd linux-mcp
make build

二进制文件会放置在 bin/linux-mcp。

如需构建完全静态二进制文件（不依赖 libc）：

make build-static

用法

此服务遵循 MCP 标准，通过 STDIO 传输方式通信。它旨在由 MCP 客户端启动（例如 Claude Desktop、Claude Code、Codex、OpenCode 或任何 MCP 宿主）。

直接运行

./bin/linux-mcp

这会启动服务，并通过 STDIN/STDOUT 监听 MCP 请求。

集成

{
  "mcp": {
    "linux-mcp": {
      "type": "local",
      "command": ["/path/to/linux-mcp"],
      "enabled": true
    }
  }
}

claude mcp add linux-mcp -- /path/to/linux-mcp

claude mcp add linux-mcp --scope user -- /path/to/linux-mcp

{
  "mcpServers": {
    "linux-mcp": {
      "type": "stdio",
      "command": "/path/to/linux-mcp"
    }
  }
}

codex mcp add linux-mcp -- /path/to/linux-mcp

[mcp_servers.linux-mcp]
command = "/path/to/linux-mcp"

工具和资源

65 个工具和 19 项资源，涵盖系统、CPU、内存、磁盘、网络、进程、Docker、安全、软件包、硬件等。

完整的工具和资源参考

配置

服务可通过 JSON 文件进行配置，该文件从 ~/.config/linux-mcp/config.json 加载，也可通过 LINUX_MCP_CONFIG 环境变量指定。

{
  "log_level": "info",
  "timeouts": {
    "get_system_snapshot": "60s",
    "ping_host": "5s"
  },
  "disabled": []
}

服务还会处理 SIGHUP，以便在运行时重新加载配置文件，无需重启。

MCP 注册表

已在 MCP Registry 上发布，名称为 io.github.Mohabdo21/linux-mcp。

许可证

• MIT

依赖项

• 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 使用）