@pooml/mcp

用于 pooml 的 MCP 服务器：可以用普通 SQL 从 Claude 或任何其他 MCP 客户端查询您的日志和指标。

在您的机器上运行（stdio），通过只读 查询 API 与您的 pooml 实例通信。您的凭据保留在本地；pooml 服务器不需要任何 MCP 专属配置。

工具

• query_logs - 对日志执行 SQL 查询（级别、服务、通过 FTS5 进行全文搜索）

• query_metrics - 对指标执行 SQL 查询（计数器和仪表）

• list_metrics - 列出已有指标，以免模型猜测名称

严格只读：每个查询都会经过 pooml 的分层 SQL 校验（仅 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 位于带有 Access 的 Cloudflare Tunnel 之后，请添加服务令牌：POOML_CF_ACCESS_CLIENT_ID 和 POOML_CF_ACCESS_CLIENT_SECRET。

为什么使用 SQL

pooml 的核心主张是，您的可观测性数据是 SQLite 数据，可以用 SQL 查询——而 LLM 已经能流利地使用 SQL。不需要让模型去猜测自定义查询语言：它直接编写 SELECT service, COUNT(*) FROM logs WHERE level >= 4 ... 就能得到答案。

许可证

Apache-2.0