@pooml/mcp

MCP-Server für pooml: Fragen Sie Ihre Logs und Metriken mit einfachem SQL von Claude oder jedem anderen MCP-Client ab.

Läuft auf Ihrem Rechner (stdio) und kommuniziert über seine schreibgeschützte Query-API mit Ihrer pooml-Instanz. Ihre Zugangsdaten bleiben lokal; der pooml-Server benötigt nichts MCP-Spezifisches.

Werkzeuge

• query_logs - SQL über die Logs (Level, Dienste, Volltextsuche per FTS5)

• query_metrics - SQL über die Metriken (Zähler und Messwerte)

• list_metrics - welche Metriken existieren, damit das Modell keine Namen erraten muss

Strikt schreibgeschützt: Jede Abfrage durchläuft poomls mehrschichtige SQL-Validierung (nur SELECT, Tabellen auf der Zulassungsliste, schreibgeschützte Verbindung, Timeouts, Zeilenlimits).

Einrichtung

1. Aktivieren Sie auf dem pooml-Server die Query-API: POOML_QUERY_API_ENABLED=true und POOML_QUERY_AUTH_SECRET=<min 32 chars>.

2. Fügen Sie ihn zu Ihrem MCP-Client hinzu. Für 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

Oder in .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"
      }
    }
  }
}

Falls pooml hinter einem Cloudflare Tunnel mit Access liegt, fügen Sie das Service-Token hinzu: POOML_CF_ACCESS_CLIENT_ID und POOML_CF_ACCESS_CLIENT_SECRET.

Warum SQL

Der ganze Ansatz von pooml besteht darin, dass Ihre Observability-Daten in SQLite vorliegen und mit SQL abgefragt werden - und LLMs bereits fließend SQL sprechen. Keine eigene Abfragesprache, an der das Modell herumphantasieren kann: Es schreibt SELECT service, COUNT(*) FROM logs WHERE level >= 4 ... und erhält Antworten.

Lizenz

Apache-2.0