vminfo v0.3.0 发布：新增只读 MCP，让 Claude 和 Codex 帮你检查 VPS 状态

之前给大家介绍过 VPSMarket 开源的服务器状态查看工具 vminfo：一个 Go 编写的单文件程序，可以在终端里查看 CPU、内存、磁盘、网络、负载和进程，也支持 JSON、Web 仪表盘与网络诊断。

现在 vminfo v0.3.0 已经正式发布。这次最值得关注的新功能是 vminfo mcp：让 Claude、Codex 等支持 MCP 的客户端，可以通过工具调用读取当前主机状态，并执行有边界的网络诊断。

它的定位不是让 AI 直接接管服务器，而是给模型一组明确、可审计、只读的诊断工具。对于经常管理 VPS、临时排查负载或检查网络连通性的用户，这种方式比手动复制多条命令输出更方便。

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

vminfo MCP 能做什么

vminfo mcp 通过标准输入输出启动本地 MCP Server，目前提供 7 个工具：

MCP 工具	用途
`get_system_snapshot`	获取 CPU、内存、磁盘、网络、负载、进程数量和健康状态
`list_processes`	在 Linux 上过滤、排序并查看本机进程
`resolve_dns`	使用系统 DNS 或指定 DNS 服务器解析域名
`check_port`	检查目标 TCP 端口是否可连接，并返回耗时
`ping_host`	执行有次数和超时限制的 TCP 或 ICMP 探测
`lookup_ip`	查询公网 IP、ASN、地理位置和风险信息
`get_version`	查看 vminfo 版本、提交和构建信息

例如，在目标 VPS 上运行支持本地 MCP 的 Claude Code 或 Codex CLI 后，可以直接询问：

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

也可以把主机状态和网络问题放在一次诊断里：

总结当前主机快照，然后解析 example.com、测试 TCP 443 端口，并报告连接错误或延迟。不要修改系统配置。

模型拿到的是结构化结果，不需要先从一大段终端文本里猜字段。不过需要注意，快照反映的是当前时刻，不能替代历史监控数据，也不应该从单次采样推断长期趋势。

为什么强调“只读”

服务器诊断涉及主机和进程信息，权限边界比功能数量更重要。vminfo v0.3.0 对 MCP 能力做了主动收敛：

只通过本地 stdio 通信，不监听新的网络端口
不提供 Shell 命令、文件写入、进程终止或自更新工具
不提供 Prompts 和 Resources，只暴露固定 Tools
进程命令行默认隐藏，只有显式设置 include_command: true 才会返回
list_processes 默认返回 20 条，最多 200 条
DNS、端口与 ping 都有调用次数或超时限制

这里的“只读”是指不会修改本机系统状态。DNS、端口、ping 等网络工具仍会访问指定目标；lookup_ip 会请求固定的 ip.bestcheapvps.org 服务。主机快照和进程数据也会发送给 MCP 客户端所配置的模型，因此只建议在可信的客户端和模型环境中使用。

安装或升级到 v0.3.0

Linux 和 macOS 可以使用安装脚本：

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

安装脚本会下载当前平台对应的 GitHub Release，并默认校验 SHA-256。Windows 用户可以从 v0.3.0 Release 下载 ZIP；Release 页面同时提供 Linux 的 deb、rpm、不同架构压缩包和 checksums.txt。

已经安装旧版的 Linux 或 macOS 用户可以升级：

vminfo update --version v0.3.0

如果二进制安装在当前用户不可写的 /usr/local/bin，升级时需要使用相应的管理员权限。完成后检查版本和 MCP 命令：

vminfo version
vminfo mcp --help

接入 Claude Desktop

在 Claude Desktop 的 MCP 配置中加入：

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

客户端不一定会继承 Shell 的 PATH，因此建议填写真实的绝对路径。修改配置后需要重启客户端。

需要特别说明：vminfo mcp 检查的是它实际运行所在的机器。Claude Desktop 在本地启动它时，读取的是本地电脑；如果要检查远程 VPS，需要在目标服务器安装 vminfo，并使用能够在该服务器启动命令的 MCP 客户端。vminfo 本身不会创建远程管理入口。

接入 Codex

Codex 可以使用下面的配置：

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

配置完成后，可以先让客户端调用 get_version，确认加载的是预期版本，再调用 get_system_snapshot 或其他诊断工具。

不用 MCP 也能继续当普通工具使用

MCP 只是 vminfo v0.3.0 新增的一种入口，原来的使用方式都还在：

vminfo                  # 终端 TUI
vminfo summary --json   # 单次 JSON 快照
vminfo watch --json     # 持续输出 JSON Lines
vminfo --web            # 本地 Web 仪表盘
vminfo net dns example.com
vminfo net port example.com 443
vminfo net ping example.com --tcp-port 443