Servidor MCP de Loki simple

El servidor MCP de Loki es una interfaz de Protocolo de Contexto de Modelo (MCP) para consultar los registros de Grafana Loki mediante logcli . El servidor permite a los asistentes de IA acceder y analizar los datos de registro de Loki directamente.

Características

Consulta de registros de Loki con compatibilidad total con LogQL
Obtener valores de etiquetas y metadatos
Soporte de autenticación y configuración a través de variables de entorno o archivos de configuración
Proporciona resultados formateados en diferentes formatos de salida (predeterminado, sin procesar, líneas JSON)

Prerrequisitos

Node.js v16 o superior
Mecanografiado
Grafana Loki logcli instalado y accesible en su PATH
Acceso a una instancia del servidor Loki

Instalación

Instalación mediante herrería

Para instalar Simple Loki MCP Server para Claude Desktop automáticamente a través de Smithery :

npx -y @smithery/cli install @ghrud92/simple-loki-mcp --client claude

para MCP

{
  "mcpServers": {
    "simple-loki": {
      "command": "npx",
      "args": ["-y", "simple-loki-mcp"],
      "env": {
        "LOKI_ADDR": "https://loki.sup.band"
      }
    }
  }
}

npm

Clonar el repositorio:

git clone https://github.com/ghrud92/loki-mcp.git
cd loki-mcp

Instalar dependencias:

npm install

Construir el proyecto:

npm run build

Herramientas MCP disponibles

consulta-loki

Consultar registros de Loki con opciones de filtrado.

Parámetros:

query (obligatoria): cadena de consulta de Loki (LogQL)
from : Marca de tiempo de inicio (p. ej., "2023-01-01T12:00:00Z")
to : Marca de tiempo de finalización (p. ej., "2023-01-01T13:00:00Z")
limit : Número máximo de registros a devolver
batch : tamaño del lote para los resultados de la consulta
output : Formato de salida ("predeterminado", "sin procesar" o "jsonl")
quiet : suprimir metadatos de consulta
forward : Mostrar los resultados en orden cronológico

obtener valores de etiqueta

Recuperar todos los valores para una etiqueta específica.

Parámetros:

label (obligatorio): Nombre de la etiqueta para la que se obtendrán los valores

obtener etiquetas

Recupere todas las etiquetas disponibles.

No se requieren parámetros.

Configuración

Puedes configurar el acceso a Loki usando:

Variables de entorno

LOKI_ADDR : Dirección del servidor Loki (URL)
LOKI_USERNAME : Nombre de usuario para autenticación básica
LOKI_PASSWORD : Contraseña para autenticación básica
LOKI_TENANT_ID : ID de inquilino para Loki multiinquilino
LOKI_BEARER_TOKEN : Token portador para autenticación
LOKI_BEARER_TOKEN_FILE : Archivo que contiene el token portador
LOKI_CA_FILE : Archivo CA personalizado para TLS
LOKI_CERT_FILE : Archivo de certificado de cliente para TLS
LOKI_KEY_FILE : Archivo de clave de cliente para TLS
LOKI_ORG_ID : ID de organización para configuraciones multiorganizacionales
LOKI_TLS_SKIP_VERIFY : Omitir la verificación TLS ("verdadero" o "falso")
LOKI_CONFIG_PATH : Ruta personalizada al archivo de configuración
DEBUG : Habilitar el registro de depuración

Archivos de configuración

Alternativamente, cree un archivo logcli-config.yaml en una de estas ubicaciones:

Ruta personalizada especificada por LOKI_CONFIG_PATH
Directorio de trabajo actual
Su directorio de inicio ( ~/.logcli-config.yaml )

Ejemplo de archivo de configuración:

addr: https://loki.example.com
username: user
password: pass
tenant_id: mytenant

Uso

Iniciar el servidor:

npm start

Para desarrollo:

npm run dev

Desarrollo

# Run linter
npm run lint

# Fix linting issues
npm run lint:fix

# Run tests
npm run test

Licencia

Este proyecto está licenciado bajo la licencia MIT: consulte el archivo LICENSE.md para obtener más detalles.

Integrations