系统监控工具

gopsutil-mcp是一款基于MCP协议的系统监控工具,通过gopsutil库提供主机、CPU、内存、磁盘和网络的实时监控功能,适用于开发和调试。

  • by next-evolve-x
  • Go
  • 本地部署
  • 更新于
在 GitHub 查看 next-evolve-x/mcp-gosputils

使用说明

gopsutil-mcp——通过模型上下文协议(mcp)的系统监控工具

gopsutil-mcp 是一个 MCP(模型上下文协议) 使用 gopsutil 图书馆。它允许LLM驱动的应用程序(例如Cursor、Continue.dev或其他MCP兼容客户端)从其运行的机器中安全地检索实时主机、CPU、内存、磁盘和网络指标。


✨ 特性

  • 主机信息:主机名、操作系统、平台、内核版本、启动时间
  • CPU统计信息:使用百分比和核心数量
  • 内存统计信息:总内存、可用内存、已用内存和使用率百分比
  • 磁盘使用:任何路径的可用/已用空间(默认为 / 或 C:)
  • 网络I/O:发送/接收的字节和数据包

所有工具都需要 无身份验证 并在本地运行——非常适合开发、调试或内部工具。


🚀 快速开始

先决条件

  • 转到1.21+
  • MCP兼容客户端(例如。, 光标, 继续)

构建与运行

# Clone (if needed)
git clone https://github.com/your-username/gopsutil-mcp.git
cd gopsutil-mcp

# Build
go build -o gopsutil-mcp .

# Run (communicates via stdin/stdout)
./gopsutil-mcp

💡 服务器使用 标准 用于MCP通信。除非集成到管理stdio的父进程中,否则不要将其作为后台守护进程运行。


🔧 工具参考

工具名称 描述 参数
get_host_info 获取操作系统和主机元数据 无
get_cpu_info 获取CPU使用率和核心数量 无
get_memory_info 获取内存使用统计数据 无
get_disk_usage 获取路径的磁盘使用情况 path (字符串,可选;默认为 / 或 C:)
get_network_stats 获取网络I/O计数器 无

⚠️ 注意:所有回复均以如下形式返回 JSON字符串 内部a text 内容块(根据MCP规范)。

示例响应(get_host_info)

{
  "hostname": "my-laptop",
  "os": "linux",
  "platform": "ubuntu",
  "platform_version": "22.04",
  "kernel_version": "5.15.0-101-generic",
  "boot_time": 1717020000
}

📦 整合

要在MCP客户端中使用:

  1. 发射 gopsutil-mcp 作为一个子流程。
  2. 通过stdio连接。
  3. 按名称调用工具(例如。, "get_memory_info" 与空 {} args)。

LLM提示示例:

“检查系统上有多少可用内存。”

LLM将调用 get_memory_info,解析JSON响应,并报告结果。


🛡️ 安全说明

  • 这个工具 公开系统信息--仅在受信任的环境中运行。
  • 未实施沙盒或访问控制。
  • 除非经过强化,否则避免在生产服务器或多租户系统上运行。

📄 许可证

MIT许可证。看 许可证 了解详情。


🙌 致谢


💡 小贴士:使用此服务器让您的AI助手“关注”本地机器的健康状况!