`vminfo mcp`

无需额外安装守护进程、数据库或独立 MCP 软件包，即可让 MCP 客户端读取当前主机指标并执行有边界的网络诊断。MCP 服务器已经包含在常规 vminfo 发布二进制中。

Claude Code 通过 vminfo MCP 检查主机健康状态

该命令通过标准输入输出启动只提供 Tools 的 Model Context Protocol 服务器：

bash

vminfo mcp

该命令应由 MCP 客户端启动。它不会监听网络端口、启动 Web 仪表盘或执行后台更新检查，并会在客户端断开后退出。

该二进制检查的是它实际运行所在的机器。若要检查另一台服务器，需要在目标服务器安装 vminfo，并由能够在该服务器启动进程的 MCP 客户端运行它；vminfo mcp 本身不会创建远程管理入口。

安装

Linux 和 macOS：

bash

curl -fsSL https://raw.githubusercontent.com/cloudapp3/vminfo/main/install.sh | sudo bash -s -- --dir /usr/local/bin

Windows、软件包、压缩包和 Go 安装方式参见安装说明。

Claude Desktop：

json

{
  "mcpServers": {
    "vminfo": {
      "command": "/usr/local/bin/vminfo",
      "args": ["mcp"]
    }
  }
}

Codex：

toml

[mcp_servers.vminfo]
command = "/usr/local/bin/vminfo"
args = ["mcp"]

如果 MCP 客户端不会继承 Shell 的 PATH，请填写二进制的真实绝对路径。修改配置后需要重启客户端。

建议同时说明诊断目标和禁止修改的边界：

text

检查这台主机当前的 CPU、内存、磁盘和网络健康状态，并列出内存占用最高的 5 个进程。不要执行任何修改。

text

解析 example.com，测试 TCP 443 端口，并报告延迟或连接错误。

text

总结当前主机快照，只解释返回指标能够支持的告警。不要从单次采样推断历史趋势。

list_processes 在 macOS 和 Windows 上返回 unsupported tool error。ICMP ping 可能需要操作系统权限，默认 TCP ping 可跨平台使用。

请只在可信的 MCP 客户端和模型环境中配置该服务器。