Graylog

Queries Graylog logs via MCP with absolute/relative timestamps, stream filtering, and system health checks.

javascript

1

GitHub Stars

javascript

Language

4 months ago

First Indexed

3 weeks ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "pranavj17-mcp-server-graylog": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-server-graylog"
      ],
      "env": {
        "BASE_URL": "https://graylog.example.com",
        "API_TOKEN": "your_api_token_here"
      }
    }
  }
}

You deploy this MCP server to search Graylog logs and debug production issues directly from your tooling. It lets you query by absolute or relative timestamps, filter by streams, and verify connectivity to Graylog, all through a lightweight MCP interface you can run locally or via a remote MCP endpoint.

How to use

You integrate the Graylog MCP server with your MCP client to perform log searches and health checks. Use the search tools to query logs by exact timestamps or recent time windows, filter results by stream IDs, and retrieve system information to verify connectivity. Start the MCP server using one of the supported local execution methods, then configure your MCP client to point to the appropriate command or URL.

How to install

Prerequisites: Node.js v18 or later and npm installed on your machine.

Option 1 — Use with npx (recommended) You can run the MCP server directly without installation.

# No installation needed - use directly with npx
npx mcp-server-graylog

Option 2 — Global installation You can install the MCP server globally so you can run it from anywhere.

npm install -g mcp-server-graylog

Option 3 — Local installation Clone the repository, install dependencies, and run locally.

# Clone the repository
git clone https://github.com/Pranavj17/mcp-server-graylog.git
cd mcp-server-graylog

# Install dependencies
npm install

# Start in development mode (example; adjust as needed)
npm run dev

Configuration and runtime options

Configure how you run the MCP server by choosing an execution method and supplying the required environment variables.

Configuration placeholders

Environment variables you must provide when running the server in any mode.

Available tools

search_logs_absolute

Search logs using absolute timestamps with a from and to window to debug specific events.

search_logs_relative

Search logs using a relative time range (last N seconds) for quick near-term analysis.

list_streams

List all available Graylog streams to discover IDs for filtering.

get_system_info

Retrieve Graylog system information and health status to verify connectivity.