使用说明
gopsutil-mcp——通过模型上下文协议(mcp)的系统监控工具
gopsutil-mcp 是一个 MCP(模型上下文协议) 使用 gopsutil 图书馆。它允许LLM驱动的应用程序(例如Cursor、Continue.dev或其他MCP兼容客户端)从其运行的机器中安全地检索实时主机、CPU、内存、磁盘和网络指标。
✨ 特性
- 主机信息:主机名、操作系统、平台、内核版本、启动时间
- CPU统计信息:使用百分比和核心数量
- 内存统计信息:总内存、可用内存、已用内存和使用率百分比
- 磁盘使用:任何路径的可用/已用空间(默认为
/或C:) - 网络I/O:发送/接收的字节和数据包
所有工具都需要 无身份验证 并在本地运行——非常适合开发、调试或内部工具。
🚀 快速开始
先决条件
构建与运行
# 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客户端中使用:
- 发射
gopsutil-mcp作为一个子流程。 - 通过stdio连接。
- 按名称调用工具(例如。,
"get_memory_info"与空{}args)。
LLM提示示例:
“检查系统上有多少可用内存。”
LLM将调用 get_memory_info,解析JSON响应,并报告结果。
🛡️ 安全说明
- 这个工具 公开系统信息--仅在受信任的环境中运行。
- 未实施沙盒或访问控制。
- 除非经过强化,否则避免在生产服务器或多租户系统上运行。
📄 许可证
MIT许可证。看 许可证 了解详情。
🙌 致谢
- 戈普苏蒂尔 –Go中的跨平台系统监控
- mark3labs/mcp go –执行MCP
- 模型上下文协议 LLM工具互操作性标准
💡 小贴士:使用此服务器让您的AI助手“关注”本地机器的健康状况!
