Integrations
Provides tools for querying Grafana Loki logs using LogQL, accessing label values and metadata, and analyzing log data with support for different output formats and filtering options.
Simple Loki MCP Server
Loki MCP Server is a Model Context Protocol (MCP) interface for querying Grafana Loki logs using logcli
. The server enables AI assistants to access and analyze log data from Loki directly.
Features
- Query Loki logs with full LogQL support
- Get label values and metadata
- Authentication and configuration support via environment variables or config files
- Provides formatted results in different output formats (default, raw, JSON lines)
- Automatic fallback to HTTP API when
logcli
is not available in the environment
Prerequisites
- Node.js v16 or higher
- TypeScript
- (Optional) Grafana Loki logcli installed and accessible in your PATH. If
logcli
is not available, the server will automatically use the Loki HTTP API instead - Access to a Loki server instance
Installation
Installing via Smithery
To install Simple Loki MCP Server for Claude Desktop automatically via Smithery:
for MCP
npm
- Clone the repository:
- Install dependencies:
- Build the project:
Available MCP Tools
query-loki
Query logs from Loki with filtering options.
Parameters:
query
(required): Loki query string (LogQL)from
: Start timestamp (e.g. "2023-01-01T12:00:00Z")to
: End timestamp (e.g. "2023-01-01T13:00:00Z")limit
: Maximum number of logs to returnbatch
: Batch size for query resultsoutput
: Output format ("default", "raw", or "jsonl")quiet
: Suppress query metadataforward
: Display results in chronological order
get-label-values
Retrieve all values for a specific label.
Parameters:
label
(required): Label name to get values for
get-labels
Retrieve all available labels.
No parameters required.
Configuration
You can configure Loki access using:
Environment Variables
LOKI_ADDR
: Loki server address (URL)LOKI_USERNAME
: Username for basic authLOKI_PASSWORD
: Password for basic authLOKI_TENANT_ID
: Tenant ID for multi-tenant LokiLOKI_BEARER_TOKEN
: Bearer token for authenticationLOKI_BEARER_TOKEN_FILE
: File containing bearer tokenLOKI_CA_FILE
: Custom CA file for TLSLOKI_CERT_FILE
: Client certificate file for TLSLOKI_KEY_FILE
: Client key file for TLSLOKI_ORG_ID
: Organization ID for multi-org setupsLOKI_TLS_SKIP_VERIFY
: Skip TLS verification ("true" or "false")LOKI_CONFIG_PATH
: Custom path to config fileDEBUG
: Enable debug logging
Note: When the client is using the HTTP API mode (when
logcli
is not available), the same configuration parameters are used to authenticate and connect to the Loki server.
Config Files
Alternatively, create a logcli-config.yaml
file in one of these locations:
- Custom path specified by
LOKI_CONFIG_PATH
- Current working directory
- Your home directory (
~/.logcli-config.yaml
)
Example config file:
Usage
Start the server:
For development:
Implementation Details
Automatic Fallback to HTTP API
The server will automatically check if logcli
is installed and available in the environment:
- If
logcli
is available, it will be used for all queries, providing the full functionality of the CLI tool - If
logcli
is not available, the server will automatically fall back to using the Loki HTTP API:- No additional configuration is needed
- The same authentication parameters are used for the HTTP API
- Response formatting is consistent with the CLI output
- Default limit of 1000 logs per query is applied in both modes
This automatic detection ensures that the server works seamlessly in different environments without manual configuration.
Development
License
This project is licensed under the MIT License - see the LICENSE.md file for details.
You must be authenticated.
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
An MCP interface that allows AI assistants to query and analyze Grafana Loki logs using LogQL, with support for authentication and various output formats.
Related MCP Servers
- AsecurityFlicenseAqualityInteracts with LogSeq via its API.Last updated -225Python
- -securityAlicense-qualityA proxy server that enables AI assistants to run and interact with command-line applications like Expo through the Model Context Protocol (MCP), capturing logs and allowing keypress forwarding.Last updated -126TypeScriptMIT License
- -securityFlicense-qualityAn MCP server that connects to Backlog API, providing functionality to search, retrieve, and update issues through natural language commands.Last updated -241JavaScript
- -securityAlicense-qualityAn MCP server that allows AI assistants to interact with Foundry datasets, ontology objects, and functions through natural language queries and commands.Last updated -2PythonMIT License