Skip to main content
Glama
mvs5465-test

Loki MCP Server

by mvs5465-test
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Remote

Loki MCP Server

An MCP (Model Context Protocol) server for semantic log querying via Loki. Designed to help AI models answer natural language questions about your cluster logs.

Features

  • Error Summary: Aggregate errors across your cluster with breakdowns by type

  • Pod Restart Detection: Find crashing/restarting pods

  • Log Search: Regex-based log search across your cluster

  • Namespace/Pod Discovery: List available namespaces and query specific pods

  • Semantic Tool Design: Tool names and parameters match natural language questions

Related MCP server: Log MCP Server

Tools

get_error_summary

Get a summary of errors happening in your cluster.

  • namespace: Filter to specific namespace (empty = all)

  • hours: Look back this many hours (default: 1)

find_pod_restarts

Find pods that have restarted or crashed recently.

  • namespace: Filter to specific namespace (empty = all)

  • hours: Look back this many hours (default: 1)

search_logs

Search logs with a regex pattern.

  • query: Regex pattern to search for

  • namespace: Filter to specific namespace (empty = all)

  • hours: Look back this many hours (default: 1)

  • limit: Maximum log lines to return (default: 100)

list_namespaces

List all namespaces that have logs in Loki.

get_pod_logs

Get logs for a specific pod.

  • pod_name: Pod name (supports wildcards like ollama*)

  • namespace: Namespace of the pod (empty = search all)

  • hours: Look back this many hours (default: 1)

  • limit: Maximum log lines to return (default: 100)

Development

# Install dependencies
uv sync

# Run the server
uv run server.py

The server exposes FastMCP over streamable HTTP at /mcp (default port 8000).

Deployment (In-Cluster)

Add to your local-k8s-apps Helm values with:

  • Deployment with the MCP server

  • Exposed via HTTP on port 8000

  • Environment variable: LOKI_URL pointing to Loki service

The Ollama MCP bridge will load this server's tools and expose them to the model.

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityInactive
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • OpenTelemetry MCP Server

    agarwalvivek29
    F
    license
    A
    quality
    D
    maintenance
    Enables AI agents to query Prometheus metrics and Loki logs for intelligent alert investigation and troubleshooting. Provides service discovery, metric querying, log searching, and correlation tools to help identify root causes of issues.
    9
    -

  • Log MCP Server

    thhart
    A
    license
    A
    quality
    C
    maintenance
    Enables AI assistants to automatically inspect and analyze application runtime log files for debugging and troubleshooting. Supports monitoring multiple log directories simultaneously with tools for listing, reading, searching, and paginating through log files.
    8
    MIT

  • Grafana-Loki MCP Server

    tumf
    A
    license
    Not graded
    quality
    D
    maintenance
    Enables querying and formatting Loki logs from Grafana via the Model Context Protocol. It supports LogQL queries, label retrieval, and provides results in text, JSON, or markdown formats.
    70 PyPI
    29
    MIT

  • tiny-loki-mcp

    myers-gh1328
    A
    license
    A
    quality
    D
    maintenance
    Enables read-only querying of Grafana Loki logs through tools like label discovery, LogQL queries, and recent log retrieval, without requiring knowledge of the Loki API.
    4
    MIT