Servidor MCP local de Loki

Un pequeño servidor MCP de solo lectura para una instancia local de Grafana Loki. Está construido con FastAPI y el SDK oficial de MCP Python.

Lo que expone

• search_logs(service, start, end, text=None) — busca un servicio requerido y texto literal opcional dentro de un rango de tiempo RFC 3339 requerido.

• list_services(start, end) — enumera los valores disponibles de la etiqueta de servicio.

• loki_health() — comprueba si Loki está listo.

La herramienta pública no tiene un parámetro limit. La solicitud también omite el parámetro de consulta limit de Loki, por lo que se aplica el valor predeterminado/máximo configurado por Loki.

Related MCP server: grafana-mcp

Cómo ejecutarlo

1. Instala Python 3.11 o superior y luego crea y activa un entorno virtual.

   py -3.11 -m venv .venv
   .\.venv\Scripts\Activate.ps1
   pip install -r requirements.txt

2. Define las variables de entorno en tu shell si los valores predeterminados no coinciden con tu configuración. .env.example enumera los ajustes disponibles. Los valores predeterminados esperan que Loki esté en http://127.0.0.1:3100 y que haya una etiqueta service_name.

3. Inicia el servidor.

   uvicorn main:app --reload

El endpoint Streamable HTTP de MCP es http://127.0.0.1:8000/mcp. El endpoint de salud del servidor es http://127.0.0.1:8000/health.

Ejemplo

La llamada a search_logs con:

{
  "service": "checkout",
  "text": "connection refused",
  "start": "2026-08-26T08:00:00Z",
  "end": "2026-08-26T09:00:00Z"
}

genera esta consulta LogQL:

{service_name="checkout"} |= "connection refused"

Si tus etiquetas usan app en su lugar, inicia el servidor con $env:LOKI_SERVICE_LABEL = "app".