Skip to main content
Glama
ThainaJardim

observability-mcp

by ThainaJardim
OverviewSchemaRelated ServersScoreDiscussions
Python

observability-mcp

MCP (Model Context Protocol) servers that let AI assistants query your observability stack — Grafana/Loki for logs and Thanos/Prometheus for metrics — directly from Cursor, Claude Desktop, or any MCP-compatible client.

Packages

Package

Entry-point

What it does

grafana_mcp

grafana-mcp

Query Loki logs via Grafana datasource proxy

thanos_mcp

thanos-mcp

Query Prometheus/Thanos metrics (PromQL)

observability_mcp

observability-mcp

Combined server — all tools in one connection

Related MCP server: mcp-server-logs-sieve

Requirements

  • Python 3.10+

  • Access to a running Grafana instance (for grafana_mcp)

  • Access to a Thanos or Prometheus instance (for thanos_mcp)

Installation

From GitHub (recommended)

Install directly from the repo without cloning:

pip install "observability-mcp @ git+https://github.com/ThainaJardim/observability-mcp.git"

# With browser-cookie support for Grafana SSO:
pip install "observability-mcp[browser-cookie] @ git+https://github.com/ThainaJardim/observability-mcp.git"

After installation, the grafana-mcp, thanos-mcp, and observability-mcp commands are available.

From source (local clone)

git clone https://github.com/ThainaJardim/observability-mcp.git
cd observability-mcp

pip install .

# For automatic Grafana SSO login via browser cookies (macOS/Linux):
pip install ".[browser-cookie]"

Quick start

Grafana / Loki

export GRAFANA_URL=https://grafana.example.com
export LOKI_DATASOURCE_ID=1          # numeric datasource ID in Grafana
export OIDC_ISSUER=https://keycloak.example.com/auth/realms/myrealm

grafana-mcp

Thanos / Prometheus

export THANOS_URL=https://thanos.example.com
export OIDC_ISSUER=https://keycloak.example.com/auth/realms/myrealm

thanos-mcp

Combined (both in one server)

# Set all env vars from above, then:
observability-mcp

Authentication

Grafana MCP

Auth mode is auto-detected from environment variables (or forced with GRAFANA_AUTH_MODE):

Mode

How it works

Variables needed

browser-cookie (default)

Reads Keycloak SSO cookies from Chrome, follows the Grafana OAuth flow automatically, caches grafana_session locally

OIDC_ISSUER, GRAFANA_URL

token

Grafana service-account token

GRAFANA_BEARER_TOKEN

cookie

Static grafana_session cookie

GRAFANA_SESSION_COOKIE

kubeconfig

OIDC id-token from kubectl kubeconfig

OIDC_ISSUER

browser-cookie mode requires browser-cookie3 (pip install ".[browser-cookie]"). On first use it reads Chrome's cookie store — you may be prompted to allow macOS Keychain access. You must be logged into Grafana in Chrome at least once.

Thanos MCP

Auth mode is auto-detected (or forced with THANOS_AUTH_MODE):

Mode

How it works

Variables needed

kubeconfig (default)

OIDC id-token from kubectl kubeconfig, auto-refreshed

OIDC_ISSUER, kubectl on PATH

token

Static Bearer token

THANOS_ACCESS_TOKEN

cookie

oauth2-proxy session cookie

THANOS_SESSION_COOKIE

Cursor MCP configuration

Create or edit .cursor/mcp.json in your project:

{
  "mcpServers": {
    "grafana": {
      "command": "python",
      "args": ["-m", "grafana_mcp.server"],
      "env": {
        "GRAFANA_URL": "https://grafana.example.com",
        "LOKI_DATASOURCE_ID": "1",
        "OIDC_ISSUER": "https://keycloak.example.com/auth/realms/myrealm",
        "PATH": "/usr/local/bin:/usr/bin:/bin"
      }
    },
    "thanos": {
      "command": "python",
      "args": ["-m", "thanos_mcp.server"],
      "env": {
        "THANOS_URL": "https://thanos.example.com",
        "OIDC_ISSUER": "https://keycloak.example.com/auth/realms/myrealm",
        "PATH": "/usr/local/bin:/usr/bin:/bin"
      }
    }
  }
}

Tip: Use an absolute Python interpreter path (e.g. /usr/local/bin/python3) if Cursor cannot find python in its PATH.

Combined server (one entry)

{
  "mcpServers": {
    "observability": {
      "command": "python",
      "args": ["-m", "observability_mcp.server"],
      "env": {
        "GRAFANA_URL": "https://grafana.example.com",
        "LOKI_DATASOURCE_ID": "1",
        "THANOS_URL": "https://thanos.example.com",
        "OIDC_ISSUER": "https://keycloak.example.com/auth/realms/myrealm",
        "PATH": "/usr/local/bin:/usr/bin:/bin"
      }
    }
  }
}

Available MCP tools

Grafana/Loki tools (grafana_mcp)

Tool

Description

query_loki_logs

Run a LogQL range query and return matching log streams

query_loki_instant

Run a LogQL instant query

list_loki_labels

List all available Loki label names

list_loki_label_values

List values for a specific Loki label

Thanos/Prometheus tools (thanos_mcp)

Tool

Description

query_metrics

Run an instant PromQL query

query_metrics_range

Run a PromQL range query

list_labels

List all metric label names

list_series

List time-series matching a selector

Development

# Install in editable mode with dev extras
pip install -e ".[dev,browser-cookie]"

# Run tests
pytest

# Run a specific server locally
python -m grafana_mcp.server
python -m thanos_mcp.server
python -m observability_mcp.server

Environment variable reference

Variable

Default

Description

GRAFANA_URL

(required)

Grafana base URL

LOKI_DATASOURCE_ID

(required)

Numeric Loki datasource ID in Grafana

GRAFANA_AUTH_MODE

auto

Force Grafana auth mode

GRAFANA_BEARER_TOKEN

—

Grafana service-account token

GRAFANA_SESSION_COOKIE

—

grafana_session cookie value

GRAFANA_SESSION_CACHE

~/.cache/grafana-mcp/session.json

Path to session cache file

THANOS_URL

(required)

Thanos/Prometheus base URL

THANOS_AUTH_MODE

auto

Force Thanos auth mode

THANOS_ACCESS_TOKEN

—

Static Bearer token

THANOS_SESSION_COOKIE

—

oauth2-proxy cookie value

OIDC_ISSUER

—

OIDC issuer URL (Keycloak realm URL)

REQUEST_TIMEOUT_SECONDS

30

HTTP timeout for all requests

LOG_LEVEL

INFO

Logging level

License

MIT

Install Server
A
license - permissive license
A
quality
D
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
–Release cycle
–Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

Related MCP Servers

  • Grafana MCP Server

    DrDroidLab
    A
    license
    A
    quality
    D
    maintenance
    A server that enables AI assistants to access and query Grafana dashboards, metrics, logs, and configurations through an MCP protocol interface.
    10
    6
    MIT

  • mcp-server-logs-sieve

    Oluwatunmise-olat
    A
    license
    -
    quality
    C
    maintenance
    An MCP server that connects Claude (or any MCP compatible client) to your existing log infrastructure. Query, summarize, and trace logs in plain English across GCP Cloud Logging, AWS CloudWatch, Azure Log Analytics, Grafana Loki, and Elasticsearch without writing filter expressions or leaving your editor.
    10
    3
    MIT

  • Proms MCP Server

    app-sre
    A
    license
    -
    quality
    D
    maintenance
    A lean MCP server that provides LLM agents with transparent access to multiple Prometheus instances for metrics analysis and SRE operations.
    4
    GPL 2.0

  • loki-mcp-server

    mo-silent
    F
    license
    -
    quality
    F
    maintenance
    An MCP server that enables AI assistants to query and analyze logs from Grafana Loki using LogQL, supporting label discovery and keyword search.
    4

View all related MCP servers

Related MCP Connectors

  • microservices.sh

    MCP server for AI agents to plan, verify, and deploy Cloudflare-native apps.

  • hithereiamaliff-mcp-nextcloud

    A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…

  • XMemo

    User-owned memory for AI agents, Copilot, Claude, IDEs, CLIs, and chat apps over remote MCP.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/ThainaJardim/observability-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server