Loki MCP Server

@scottlepp

Repository Homepage

Basic information

About Loki MCP Server

An MCP ( Model Context Protocol ) Server for Grafana Loki

#golang #mcp #grafana#loki#agentic-workflow #agentic-ai #mcp-server

Loki MCP Server config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "loki-mcp": {
      "command": "docker",
      "args": [
        "build",
        "-t",
        "loki-mcp-server",
        "."
      ]
    }
  }
}

Loki MCP Server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Loki MCP Server?

Loki MCP Server is a Go-based server implementation for the Model Context Protocol (MCP) with Grafana Loki integration. It allows AI assistants and MCP-compatible clients to query Loki log data using LogQL via the loki_query tool.

How to use Loki MCP Server?

Build and run the server with Go (go build / go run) or Docker. It communicates using stdin/stdout and also supports HTTP with Server-Sent Events (SSE). Configuration is done through environment variables for Loki URL, organization ID, and authentication. To use with Claude Desktop, add the server to the MCP configuration file.

Key features of Loki MCP Server

Provides a loki_query tool for executing LogQL queries.
Supports both stdin/stdout and SSE (HTTP) communication modes.
Configurable via environment variables (LOKI_URL, LOKI_ORG_ID, LOKI_USERNAME, LOKI_PASSWORD, LOKI_TOKEN).
Can be run locally with Docker Compose including Loki, Grafana, and a log generator.
Supports multi-tenant setups via the X-Scope-OrgID header.
Includes a test client and scripts for verification.

Use cases of Loki MCP Server

Querying Grafana Loki logs from AI assistants like Claude Desktop.
Multi-tenant log analysis with organization ID mapping.
Real-time log querying and debugging via natural language prompts.
Integration into n8n workflows using the SSE endpoint.
Local development and testing of Loki queries with Docker Compose.

Frequently asked questions

What dependencies are required?

Go 1.16 or higher is required to build from source. Docker is optional for containerized deployment.

How does authentication work?

Authentication is configured via environment variables: LOKI_USERNAME and LOKI_PASSWORD for basic auth, or LOKI_TOKEN for bearer token. These are used when not specified in the request.

What transports are supported?

The server supports stdin/stdout (standard MCP) and HTTP with Server-Sent Events (SSE) on port 8080, configurable via the SSE_PORT environment variable.

Where does the data live?

The server acts as a proxy to a Grafana Loki server. Log data resides in Loki, which must be reachable via the configured URL (default http://localhost:3100). The server itself does not persist log data.

Can I use it with multi-tenant Loki?

Yes, the `org` parameter and LOKI_ORG_ID environment variable allow specifying an organization ID, sent as the X-Scope-OrgID header for multi-tenant setups.

Comments

More Other MCP servers

Soar Flight Booking MCP

Soar Flight Booking MCP is a remote MCP server available at https://mcp.soar.flights.

Health by Dr Brad

Dr Brad Stanfield

Health by Dr Brad works out a health plan from your own results: which screening is due at your age, and evidence-based suggestions, each with the reason and the published guideline or study behind it. Your record is one

PickFu MCP

PickFu MCP is a Model Context Protocol (MCP) server that connects AI assistants, developers, marketers, product managers, and AI agents to PickFu's consumer research platform. It enables users to create surveys, conduct

Awesome Mlops

visenger

A curated list of references for MLOps

14.0K

EverArt

modelcontextprotocol

Model Context Protocol Servers

88.1K