@pooml/mcp

Servidor MCP para pooml: consulta tus logs y métricas con SQL simple desde Claude, o cualquier otro cliente MCP.

Se ejecuta en tu máquina (stdio), se comunica con tu instancia de pooml a través de su API de consulta de solo lectura. Tus credenciales permanecen locales; el servidor de pooml no necesita nada específico de MCP.

Herramientas

• query_logs - SQL sobre los logs (niveles, servicios, búsqueda de texto completo mediante FTS5)

• query_metrics - SQL sobre las métricas (contadores y medidores)

• list_metrics - qué métricas existen, para que el modelo no adivine los nombres

Estrictamente de solo lectura: cada consulta pasa por la validación SQL en capas de pooml (SELECT-only, tablas en lista blanca, conexión de solo lectura, tiempos de espera, límites de filas).

Configuración

1. En el servidor de pooml, habilita la API de consulta: POOML_QUERY_API_ENABLED=true y POOML_QUERY_AUTH_SECRET=<min 32 chars>.

2. Añádelo a tu cliente MCP. Para Claude Code:

claude mcp add pooml \
  -e POOML_URL=https://your-pooml-host:8080 \
  -e POOML_QUERY_AUTH_SECRET=your-query-secret \
  -- npx -y @pooml/mcp

O en .mcp.json:

{
  "mcpServers": {
    "pooml": {
      "command": "npx",
      "args": ["-y", "@pooml/mcp"],
      "env": {
        "POOML_URL": "https://your-pooml-host:8080",
        "POOML_QUERY_AUTH_SECRET": "your-query-secret"
      }
    }
  }
}

Si pooml se encuentra detrás de un Cloudflare Tunnel con Access, añade el token de servicio: POOML_CF_ACCESS_CLIENT_ID y POOML_CF_ACCESS_CLIENT_SECRET.

Por qué SQL

La propuesta de pooml es que tus datos de observabilidad son SQLite consultados con SQL - y los LLM ya hablan SQL con fluidez. No hay un lenguaje de consulta personalizado con el que el modelo pueda alucinar: escribe SELECT service, COUNT(*) FROM logs WHERE level >= 4 ... y obtiene respuestas.

Licencia

Apache-2.0