Mimir MCP Server
PanAndrew/mimir-mcp
Consulte métricas Prometheus/Mimir via Claude com PromQL e remote-read
Ver no GitHubServidor 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-mcp1 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
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-OrgIDheader - 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
| Tool | Description |
|---|---|
mimir_promql_query | Execute a PromQL range query |
mimir_query_long_period | Protobuf remote-read for long time ranges, result saved to file |
mimir_list_metrics | List all metric names |
mimir_list_labels | List all label names |
mimir_list_label_values | List values for a specific label |
get_current_timestamp_ms | Current Unix timestamp in milliseconds |
get_current_timestamp_seconds | Current Unix timestamp in seconds |
get_supported_tenant_name | Returns the configured tenant/org ID |
MCP Prompts
| Prompt | Description |
|---|---|
how_to_use_promql_and_analyse_weight_metric_data | Expert 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)
| Variable | Description |
|---|---|
LOCAL_PORT | Local port to bind (should match mimir.url port) |
REMOTE_ADDR_L | Remote Mimir host IP |
REMOTE_PORT_L | Remote Mimir port |
SSH_USER | SSH username |
SSH_HOST | SSH jump host |
SSH_KEY_PATH | Path 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