项目简介

这是一个基于Model Context Protocol (MCP) 的服务器实现,专门用于连接LibreNMS网络监控系统。它允许AI助手通过标准化的协议访问网络设备状态、性能指标、告警信息等监控数据。

主要功能

  • 设备监控:查询网络设备列表、状态、可用性和中断记录
  • 端口管理:获取端口信息、接口统计数据和状态
  • 告警系统:查看当前和历史告警,管理告警规则
  • 网络拓扑:访问VLAN信息、链路状态和路由数据
  • 库存信息:查看设备硬件配置和组件信息
  • 位置管理:管理设备物理位置信息
  • 计费数据:获取网络流量计费信息
  • 日志查询:访问系统日志、事件日志和认证日志
  • 支持读写操作和只读安全模式

安装步骤

  1. 克隆仓库:'git clone https://github.com/mhajder/librenms-mcp.git'
  2. 安装依赖:使用'uv sync'或'pip install -e .'
  3. 配置环境变量:复制'.env.example'为'.env'并填写LibreNMS连接信息
  4. 运行服务器:'uv run python run_server.py'

服务器配置

MCP客户端需要配置以下信息连接此服务器:

{
  "command": "python",
  "args": ["run_server.py"]
}

配置说明:

  • 需要在项目目录中创建'.env'文件,配置LibreNMS的URL和API token
  • 支持STDIO传输(默认),也支持SSE和HTTP传输
  • 可配置只读模式保护生产环境
  • 支持速率限制防止API滥用

基本使用方法

  1. 确保LibreNMS系统正常运行且API可访问
  2. 配置环境变量:'LIBRENMS_URL'和'LIBRENMS_TOKEN'
  3. 服务器启动后,MCP客户端即可调用各种网络监控工具
  4. 在只读模式下,仅能执行查询操作,所有修改功能将被禁用

信息

分类

开发者工具