Loki MCP

🚀 Simple Loki MCP Server

The Loki MCP Server is an interface for the Model Context Protocol (MCP), which enables querying Grafana Loki logs via logcli. This server allows AI assistants to directly access and analyze Loki's log data.

✨ Features

• Support querying Loki logs using full LogQL.
• Retrieve label values and metadata.
• Support authentication and configuration via environment variables or configuration files.
• Provide formatted results in different output formats (default, raw, JSON lines).
• Automatically fallback to the HTTP API when the logcli environment is unavailable.

🚀 Quick Start

Prerequisites

• Node.js v16 or higher.
• TypeScript.
• (Optional) Grafana Loki logcli installed and accessible in the PATH. If logcli is unavailable, the server will automatically use the Loki HTTP API.
• Access to a Loki server instance.

📦 Installation

Install via Smithery

To automatically install the Simple Loki MCP Server for Claude Desktop via Smithery:

npx -y @smithery/cli install @ghrud92/simple-loki-mcp --client claude

For MCP

{
  "mcpServers": {
    "simple-loki": {
      "command": "npx",
      "args": ["-y", "simple-loki-mcp"],
      "env": {
        "LOKI_ADDR": "https://loki.sup.band"
      }
    }
  }
}

npm

1. Clone the repository:

git clone https://github.com/ghrud92/simple-loki-mcp.git
cd simple-loki-mcp
npm install

💻 Usage Examples

simple-loki

Description

Used for querying and analyzing Loki logs.

Parameters

• --addr or -a: Specify the address of the Loki server (default: http://localhost:3100).
• --query or -q: The log query to be executed.