Cribl

A bridge enabling AI interactions with Cribl by exposing MCP tools to manage Cribl deployments.

typescript

GitHub Stars

typescript

Language

6 months ago

First Indexed

2 months 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": {
    "pebbletek-cribl-mcp": {
      "command": "npx",
      "args": [
        "CRIBL_BASE_URL=https://your.cribl.cloud.instance",
        "CRIBL_AUTH_TYPE=cloud",
        "CRIBL_CLIENT_ID=abc123",
        "CRIBL_CLIENT_SECRET=secret",
        "@pebbletek/cribl-mcp"
      ],
      "env": {
        "CRIBL_BASE_URL": "https://your.cribl.cloud.instance",
        "CRIBL_AUTH_TYPE": "cloud",
        "CRIBL_CLIENT_ID": "abc123",
        "CRIBL_CLIENT_SECRET": "secret"
      }
    }
  }
}

You can run the Cribl MCP Server to enable AI clients to discover and invoke data operations from your Cribl deployment using standardized MCP tooling. This server acts as the bridge between your AI prompts and Cribl’s data operations, allowing safe, structured access to pipelines, sources, metrics, and more.

How to use

Connect with an MCP client to start querying and controlling your Cribl deployment. You will first run the MCP server locally or remotely, then point your client at the server’s endpoint. Use natural language prompts to discover data sources, pipelines, and system metrics, and to issue actions like restarting worker groups or updating pipelines. The server exposes a set of tools that you can invoke from your MCP client to perform these tasks.

How to install

Prerequisites: Node.js version 16 or later and internet access to fetch the MCP server package.

Install and run via npx for quick start:

CRIBL_BASE_URL=https://your.cribl.cloud.instance CRIBL_AUTH_TYPE=cloud CRIBL_CLIENT_ID=abc123 CRIBL_CLIENT_SECRET=secret npx @pebbletek/cribl-mcp

Additional setup and local development

If you prefer to run locally with dependencies installed, clone the project, install dependencies, and start the server.

Commands to run locally include these steps:

git clone https://github.com/pebbletek/cribl-mcp.git
cd cribl-mcp
npm install
cp .env.example .env

Configuration and environment variables

The server uses environment variables to connect to Cribl and authorize requests. Set the following for quick start, or configure them in a file loaded by your process manager.

CRIBL_BASE_URL=https://your.cribl.cloud.instance
CRIBL_AUTH_TYPE=cloud
CRIBL_CLIENT_ID=abc123
CRIBL_CLIENT_SECRET=secret

Available tools

Listing Worker Groups/Fleets

Query and list available worker groups or fleets to understand your Cribl processing capacity and organization.

Getting/Setting Pipeline configurations

Retrieve pipeline configurations and apply updates to pipelines to control data processing.

Getting Source configurations

Fetch source configurations to review where and how data is ingested.

Restarting Worker Groups

Restart one or more worker groups to apply changes or recover from transient issues.

Querying System Metrics

Obtain system metrics with optional filtering to monitor Cribl performance.

Built by

VeilStrat

AI signals for GTM teams