使用说明

项目简介

本项目 'AIOps主机监控MCP服务器' 是一个基于 Model Context Protocol (MCP) 构建的后端服务，专注于主机监控和诊断。它通过提供一系列工具，例如系统资源使用情况查询、进程状态检查、网络连通性测试和日志文件分析等，使LLM应用能够获取运行环境的实时信息，从而实现更智能化的运维和故障排查。

主要功能点

系统资源监控: 提供CPU、内存、磁盘等系统核心指标的实时使用率，帮助用户了解服务器的负载情况。
进程管理: 允许检查特定进程的运行状态，以及列出当前运行的服务进程及其资源消耗，辅助用户进行进程级别的性能分析。
网络诊断: 支持网络连通性检查和端口状态检测，帮助用户快速定位网络问题。
日志分析: 能够分析指定的日志文件，查找错误关键词，并返回包含错误信息的日志行，辅助用户进行问题排查。
系统信息查询: 提供主机名、操作系统、内核版本、架构等基本系统信息。

安装步骤

克隆仓库

git clone https://github.com/OrchardUniverse/aiops_mcp.git
cd aiops_mcp/host_inspector

安装依赖

本服务依赖 'psutil' 库来获取系统信息，请确保已安装该库。
```
pip install psutil
```
运行服务器

在 'host_inspector' 目录下，运行 'server.py' 脚本即可启动 MCP 服务器。
```
python server.py
```
服务器默认使用 SSE (Server-Sent Events) 传输协议。

服务器配置

MCP 客户端需要配置以下 JSON 信息才能连接到 'AIOps主机监控MCP服务器'。请根据实际情况进行配置。

{
  "server_name": "AIOps MCP Server",  // 服务名称，与server.py代码中定义的一致
  "command": "python3",             // 启动服务器的命令，假设您的环境中python3指向Python 3解释器
  "args": ["server.py"],              // 启动命令的参数，指向 server.py 脚本
  "transport": "sse"                // 使用 SSE 传输协议
}

配置参数注释:

'server_name': MCP 服务器的名称，用于客户端识别和连接。必须与 'server.py' 代码中 'FastMCP("AIOps MCP Server")' 定义的名称完全一致。
'command': 启动 MCP 服务器的命令行指令。通常为 Python 解释器的路径 ('python3', 'python', 或 Python 解释器的绝对路径)。请根据您的系统环境配置。
'args': 传递给启动命令的参数列表。对于本服务器，需要指定 'server.py' 脚本作为参数。
'transport': 指定 MCP 服务器使用的传输协议。本服务器使用 'sse' (Server-Sent Events)。

基本使用方法

启动 MCP 服务器后，MCP 客户端可以通过 JSON-RPC 协议调用以下工具 (Tools) 来获取主机信息：

'get_system_metrics': 获取系统资源使用率 (CPU, 内存, 磁盘)。
'check_process_status': 检查指定进程是否运行。
'list_running_services': 列出运行的服务进程。
'check_network_connectivity': 检查网络连通性。
'check_port_status': 检查端口状态。
'analyze_log_file': 分析日志文件中的错误信息。
'get_system_info': 获取系统基本信息。

客户端需要构造符合 MCP 协议的 JSON-RPC 请求，指定要调用的工具名称和相应的参数。服务器将返回 JSON-RPC 响应，包含工具执行结果。

关键词