项目简介
这是一个基于Model Context Protocol (MCP) 的服务器实现,专门用于连接LibreNMS网络监控系统。它允许AI助手通过标准化的协议访问网络设备状态、性能指标、告警信息等监控数据。
主要功能
- 设备监控:查询网络设备列表、状态、可用性和中断记录
- 端口管理:获取端口信息、接口统计数据和状态
- 告警系统:查看当前和历史告警,管理告警规则
- 网络拓扑:访问VLAN信息、链路状态和路由数据
- 库存信息:查看设备硬件配置和组件信息
- 位置管理:管理设备物理位置信息
- 计费数据:获取网络流量计费信息
- 日志查询:访问系统日志、事件日志和认证日志
- 支持读写操作和只读安全模式
安装步骤
- 克隆仓库:'git clone https://github.com/mhajder/librenms-mcp.git'
- 安装依赖:使用'uv sync'或'pip install -e .'
- 配置环境变量:复制'.env.example'为'.env'并填写LibreNMS连接信息
- 运行服务器:'uv run python run_server.py'
服务器配置
MCP客户端需要配置以下信息连接此服务器:
{ "command": "python", "args": ["run_server.py"] }
配置说明:
- 需要在项目目录中创建'.env'文件,配置LibreNMS的URL和API token
- 支持STDIO传输(默认),也支持SSE和HTTP传输
- 可配置只读模式保护生产环境
- 支持速率限制防止API滥用
基本使用方法
- 确保LibreNMS系统正常运行且API可访问
- 配置环境变量:'LIBRENMS_URL'和'LIBRENMS_TOKEN'
- 服务器启动后,MCP客户端即可调用各种网络监控工具
- 在只读模式下,仅能执行查询操作,所有修改功能将被禁用
信息
分类
开发者工具