LibreNMS MCP

Official

by mhajder · Python

MCP server for LibreNMS network monitoring - query devices, ports, alerts, and manage infrastructure

Queries and manages LibreNMS network monitoring for devices, ports, and alerts.

Topics

librenmsmcpmcp-servermcp-tools

Install

Configuration

Environment variables

LIBRENMS_URLrequired

LibreNMS instance URL (e.g., https://librenms.example.com)

LIBRENMS_TOKENrequiredsecret

LibreNMS API token with appropriate permissions

LIBRENMS_VERIFY_SSLdefault true

Verify TLS certificates for LibreNMS requests (true/false)

LIBRENMS_TIMEOUTdefault 30

HTTP timeout for LibreNMS API requests in seconds

READ_ONLY_MODEdefault false

Enable read-only mode to block write operations

DISABLED_TAGS

Comma-separated tool tags to disable (e.g., alerts,bills)

LOG_LEVELdefault INFO

Logging level (DEBUG, INFO, WARNING, ERROR)

RATE_LIMIT_ENABLEDdefault false

Enable per-client rate limiting (true/false)

RATE_LIMIT_MAX_REQUESTSdefault 100

Maximum requests allowed per rate-limit window

RATE_LIMIT_WINDOW_MINUTESdefault 1

Rate-limit window duration in minutes

TOOL_SEARCH_ENABLEDdefault false

Enable FastMCP tool search transform

TOOL_SEARCH_STRATEGYdefault bm25

Tool search strategy: 'bm25' (natural language) or 'regex' (pattern match)

TOOL_SEARCH_MAX_RESULTSdefault 5

Maximum number of tools returned by search_tools

MCP_HTTP_PORTdefault 8000

Port for HTTP server (default: 8000)

MCP_HTTP_BEARER_TOKENsecret

Optional bearer token for HTTP transport authentication

MCP_TRANSPORTdefault http

MCP transport type (http for HTTP, stdio for stdio)

SENTRY_DSNsecret

Sentry DSN for optional error tracking

SENTRY_TRACES_SAMPLE_RATEdefault 1.0

Sentry traces sample rate (0.0-1.0)

SENTRY_SEND_DEFAULT_PIIdefault true

Allow Sentry to include default PII in events (true/false)

SENTRY_ENVIRONMENT

Sentry environment name (e.g., production)

SENTRY_RELEASE

Sentry release identifier

SENTRY_PROFILE_SESSION_SAMPLE_RATEdefault 1.0

Sentry profile session sample rate (0.0-1.0)

SENTRY_PROFILE_LIFECYCLEdefault trace

Sentry profiling lifecycle mode

SENTRY_ENABLE_LOGSdefault true

Enable Sentry log capture integration (true/false)

Arguments

-prequireddefault {MCP_HTTP_PORT}:{MCP_HTTP_PORT}

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "librenms-mcp": {
      "command": "uvx",
      "args": [
        "librenms-mcp"
      ],
      "env": {
        "LIBRENMS_URL": "<YOUR_LIBRENMS_URL>",
        "LIBRENMS_TOKEN": "<YOUR_LIBRENMS_TOKEN>",
        "LIBRENMS_VERIFY_SSL": "true",
        "LIBRENMS_TIMEOUT": "30",
        "READ_ONLY_MODE": "false",
        "DISABLED_TAGS": "<YOUR_DISABLED_TAGS>",
        "LOG_LEVEL": "INFO",
        "RATE_LIMIT_ENABLED": "false",
        "RATE_LIMIT_MAX_REQUESTS": "100",
        "RATE_LIMIT_WINDOW_MINUTES": "1",
        "TOOL_SEARCH_ENABLED": "false",
        "TOOL_SEARCH_STRATEGY": "bm25",
        "TOOL_SEARCH_MAX_RESULTS": "5"
      }
    }
  }
}