@pooml/mcp

MCP-сервер для pooml: запрашивайте свои логи и метрики с помощью простого SQL из Claude или любого другого MCP-клиента.

Работает на вашем компьютере (stdio), общается с вашим экземпляром pooml через его API запросов, доступный только для чтения. Ваши учетные данные остаются локальными; серверу pooml не нужно ничего MCP-специфичного.

Инструменты

• query_logs - SQL по логам (уровни, сервисы, полнотекстовый поиск через FTS5)

• query_metrics - SQL по метрикам (счётчики и датчики)

• list_metrics - какие метрики существуют, чтобы модель не угадывала названия

Строго только для чтения: каждый запрос проходит через многоуровневую SQL-валидацию pooml (только SELECT, таблицы из белого списка, соединение только для чтения, таймауты, лимиты строк).

Настройка

1. На сервере pooml включите API запросов: POOML_QUERY_API_ENABLED=true и POOML_QUERY_AUTH_SECRET=<min 32 chars>.

2. Добавьте в ваш MCP-клиент. Для 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

Или в .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"
      }
    }
  }
}

Если pooml находится за Cloudflare Tunnel с Access, добавьте сервисный токен: POOML_CF_ACCESS_CLIENT_ID и POOML_CF_ACCESS_CLIENT_SECRET.

Почему SQL

Вся суть pooml в том, что ваши данные observability — это SQLite, запрашиваемый с помощью SQL — а LLM уже свободно говорят на SQL. Никакого собственного языка запросов, на котором модель могла бы галлюцинировать: она пишет SELECT service, COUNT(*) FROM logs WHERE level >= 4 ... и получает ответы.

Лицензия

Apache-2.0