@pooml/mcp

pooml 向け MCP サーバー: Claude または他の MCP クライアントから、ログと メトリクスをプレーンな SQL でクエリできます。

お使いのマシン上で動作し (stdio)、pooml インスタンスにはその読み取り専用の クエリ API を介して通信します。 認証情報はローカルに留まり、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