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)

• Retorno automático a la API HTTP cuando logcli no está disponible en el entorno

Related MCP server: Loki MCP Server

Prerrequisitos

• Node.js v16 o superior

• Mecanografiado

• (Opcional) Logcli de Grafana Loki instalado y accesible en su PATH. Si logcli no está disponible, el servidor usará automáticamente la API HTTP de Loki.

• 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

1. Clonar el repositorio:

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

2. Instalar dependencias:

npm install

3. 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

Nota : Cuando el cliente utiliza el modo API HTTP (cuando logcli no está disponible), se utilizan los mismos parámetros de configuración para autenticarse y conectarse al servidor Loki.

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

Detalles de implementación

Retorno automático a la API HTTP

El servidor comprobará automáticamente si logcli está instalado y disponible en el entorno:

1. Si logcli está disponible, se utilizará para todas las consultas, proporcionando la funcionalidad completa de la herramienta CLI.

2. Si logcli no está disponible, el servidor recurrirá automáticamente al uso de la API HTTP de Loki:

   • No se necesita ninguna configuración adicional

   • Los mismos parámetros de autenticación se utilizan para la API HTTP

   • El formato de la respuesta es consistente con la salida de la CLI

   • El límite predeterminado de 1000 registros por consulta se aplica en ambos modos

Esta detección automática garantiza que el servidor funcione sin problemas en diferentes entornos sin necesidad de configuración manual.

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.