convez.ai
MCP ServerDevOps & InfraestruturaAvançado
PanAndrew

Mimir MCP Server

PanAndrew/mimir-mcp

Consulte métricas Prometheus/Mimir via Claude com PromQL e remote-read

Ver no GitHub
InicialPluginScore · de 0 a 100

Servidor MCP em Rust que integra clientes LLM (Claude) com backend de métricas Grafana Mimir/Prometheus. Expõe consultas PromQL, descoberta de labels/métricas e remote-read em Protobuf via Model Context Protocol, permitindo que LLMs analisem dados de séries temporais compatíveis com Prometheus.

Instalação

$npx convez-ai PanAndrew/mimir-mcp

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
0
Acompanhando
0
Saúde
28%
Último commit
há 5 meses
Versão
—
Issues abertas
0
Contribuidores
1

Casos de uso

  • Análise de métricas de observabilidade via LLM
  • Consultas PromQL automatizadas integradas ao Claude
  • Exploração de dados de séries temporais sem deixar o chat

Veredito

Solução robusta e bem-estruturada para orquestração de queries Prometheus via LLM, com suporte a multi-tenancy e remote-read para períodos longos. Exige conhecimento de Rust, Prometheus/Mimir e infraestrutura observabilidade, mas oferece integração MCP nativa de qualidade produção.

README

A tradução para o português deste README ainda está na fila.

Mimir MCP Server

A Model Context Protocol (MCP) server written in Rust that bridges LLM clients (Claude, etc.) with a Grafana Mimir / Prometheus-compatible metrics backend.

Exposes PromQL queries, label/metric discovery, and protobuf remote-read via Model Context Protocol, enabling LLMs to analyze Prometheus-compatible metrics data.

Features

  • PromQL queries - execute range queries against Mimir and receive results in TOON format
  • Protobuf remote-read - query raw time-series data over long periods using the Prometheus remote-read endpoint and Protobuf protocol
  • Metric & label discovery - list metric names, label names, and label values
  • Timestamp helpers - current Unix timestamp in milliseconds / seconds
  • Multi-tenancy - configurable X-Scope-OrgID header
  • Built-in LLM prompt - context-aware PromQL instructions exposed as an MCP prompt
  • Docker + SSH tunnel - ready-to-use Docker Compose setup with an SSH tunnel sidecar

MCP Tools

ToolDescription
mimir_promql_queryExecute a PromQL range query
mimir_query_long_periodProtobuf remote-read for long time ranges, result saved to file
mimir_list_metricsList all metric names
mimir_list_labelsList all label names
mimir_list_label_valuesList values for a specific label
get_current_timestamp_msCurrent Unix timestamp in milliseconds
get_current_timestamp_secondsCurrent Unix timestamp in seconds
get_supported_tenant_nameReturns the configured tenant/org ID

MCP Prompts

PromptDescription
how_to_use_promql_and_analyse_weight_metric_dataExpert instructions for PromQL syntax and example weight-metric pattern analysis

Prerequisites

  • Rust toolchain (2024 edition)
  • protoc - Protocol Buffer compiler
  • A running Grafana Mimir or Prometheus-compatible instance

Configuration

Copy and edit config.toml:

[mimir]
url = "http://localhost:8060"
remote_read_endpoint = "/prometheus/api/v1/read"
query_range_endpoint = "/prometheus/api/v1/query_range"
default_list_labels_endpoint = "/prometheus/api/v1/labels"
default_list_label_values_endpoint = "/prometheus/api/v1/label/{}/values"
org_id = "your-org-id"          # optional, for multi-tenant setups
timeout_seconds = 60

[mcp]
bind_address = "0.0.0.0:8065"
server_name = "mimir-mcp-server"
version = "0.2.2"
prompt_path = "resources/prompt_instructions.md"

Build & Run

# Build
cargo build --release

# Run
cargo run --release

The MCP endpoint is available at http://<bind_address>/mcp.

Docker

# Run with Docker Compose (includes SSH tunnel sidecar)
nano .env  # Fill in SSH tunnel variables
docker compose up --build -d

SSH tunnel variables (.env)

VariableDescription
LOCAL_PORTLocal port to bind (should match mimir.url port)
REMOTE_ADDR_LRemote Mimir host IP
REMOTE_PORT_LRemote Mimir port
SSH_USERSSH username
SSH_HOSTSSH jump host
SSH_KEY_PATHPath to SSH private key

Tech Stack

  • Rust (2024 edition) + Tokio async runtime
  • rmcp - Rust MCP library
  • Axum - HTTP server
  • Prost - Protocol Buffers
  • Reqwest - HTTP client
  • rusty_chunkenc - Prometheus' chunkenc library
  • Snap - Snappy compression
  • toon-format - TOON serialization format
Ver o original no GitHub

Bom para

Relacionados