プロトタイプ · プレビュー版:公式レジストリのすべてのサーバーを掲載し、30分ごとに同期しています。Google でログインするとレビューを書けます。プロトタイプ · 30分ごとに更新
PopNx MCPAIを使う人のためのMCPサーバー · やさしい言葉で解説

Lagaam

作者:lagaam-aiバージョン 1.0.0i★ 1iパソコンで動くリポジトリ ↗
レジストリ名io.github.lagaam-ai/lagaam

インストール方法

What it does

Stops an agent's Trino or Pinot query before it runs if it costs too much or reads outside its grant

  • Connects パソコンで動く
  • Account or key Needs TRINO_PASSWORD, TRINO_JWT, PINOT_PASSWORD · 1 setting to fill in (LAGAAM_ALLOWED_TABLES)
  • Category その他

この順位の理由

一覧は利用スコア(100 点満点)で並びます。内訳は次のとおり

人気4/80GitHub スターか週間ダウンロード数。大きい方を 60、小さい方を 20 で数えます
新しさ12/1230 日以内のリリースかコード更新で満点
応答中0/8前回の確認でクラウドのエンドポイントが応答
利用スコア16/100

品質: 基本チェック 3/3 項目に合格(表示のみ、並び順には不使用) · 勢い: データなし (「急上昇」タブでのみ使用)

インストール

使っているAIアプリを選んで、設定をコピーしてください。

ひとことで AI にインストールしてもらう

Lagaam をインストールして。https://mcp.popnx.com/i/lagaam-ai-lagaam.md に従い、コマンドを見せて、私が OK するまで実行しないで。

パソコンで作業できる AI(Claude Code や Cursor など)に貼り付けます。手順を読み、コマンドを見せて、あなたの OK を待ちます。キー不要・登録不要。 · AI が読む全文を見る

チェック 3/3 合格 · あなたのパソコンで動きます · ✓ コマンド確認済み 2026年11月14日

まず:どの AI を使っていますか?

使っているアプリを選ぶと、下に手順が表示されます。

Claude につなげますが、先に準備が必要です

Lagaam のキーが必要です(提供元のサイトで作成) · 設定を 1 項目入力 (LAGAAM_ALLOWED_TABLES) · 先にパソコンへ Python (uv) を入れてください(1 回だけ) · パソコン版 Claude アプリ(Windows または Mac)のみ。Web やスマホでは使えません

AI にインストールしてもらう

このメッセージを Claude のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。

このパソコンの Claude に MCP server Lagaam を入れてください。順番に:1) uv --version で uv があるか確認。なければ https://docs.astral.sh/uv/getting-started/installation/ から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):{ "mcpServers": { "lagaam": { "command": "uvx", "args": [ "lagaam" ], "env": { "LAGAAM_ALLOWED_TABLES": "your-value", "TRINO_PASSWORD": "your-value", "TRINO_JWT": "your-value", "PINOT_PASSWORD": "your-value" } } } } 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) TRINO_PASSWORD, TRINO_JWT, PINOT_PASSWORD, LAGAAM_ALLOWED_TABLES は "your-value" のままにして、本当の値は私がファイルかアプリの入力欄に自分で貼るよう伝える。チャットにキーを書かせない。5) 了承した内容を実行し、Lagaam のツールが本当に表示されるか確認する。

このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。

  1. uv を入れる(まだなければ)

    もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter

    uv --version
    • バージョン番号(例 uv …)が出る = 入っています。この手順は飛ばせます
    • "command not found"(Windows では "is not recognized")が出る = まだ入っていないか、入れた直後でターミナルを開き直す必要があります
    ターミナルの開き方

    Mac:⌘ + Space を押し、Terminal と入力して Enter

    Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」

    まだ入っていない場合: uv にはクリック式のインストーラーがありません。uv 公式ページからお使いの OS(macOS か Windows)用の 1 行コマンドをコピーしてターミナルに貼り付けます · Python を別に入れる必要はなく、必要なときに uv が自動で取得します

    uv のダウンロードページを開く ↗

    入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: uv --version

    一度入れれば、uv を使うすべてのツールで使えます

  2. Lagaam に登録してキーを作る

    提供元のサイトで登録し、次の手順で使う API キーを作ります。料金や無料プランは提供元のサイトで確認してください。

    Lagaam のサイトを開く ↗

  3. 設定を 1 項目入力

    これはプログラムの設定でキーではありません。登録は不要で、作者の説明どおりに入力します。

    • LAGAAM_ALLOWED_TABLES カンマ区切りの catalog.schema.table の権限リスト。これがないとサーバーは起動しません。
      英語の原文を見るComma list of catalog.schema.table grants; the server will not start without it

    説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。

  4. パソコン版 Claude アプリの設定ファイルを開く

    SettingsDeveloperEdit Config

  5. この設定を貼り付けて保存

    {
      "mcpServers": {
        "lagaam": {
          "command": "uvx",
          "args": [
            "lagaam"
          ],
          "env": {
            "LAGAAM_ALLOWED_TABLES": "your-value",
            "TRINO_PASSWORD": "your-value",
            "TRINO_JWT": "your-value",
            "PINOT_PASSWORD": "your-value"
          }
        }
      }
    }

    キーはアプリの入力欄にだけ貼り付け、チャットに貼ったり人に送ったりしないでください

  6. Claude を終了してもう一度開く

  7. 試してみる

    Lagaam を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Claude が Lagaam を使っていると言うか、回答に Lagaam のツール名が出れば接続成功です

追加の設定 18 項目(入力しなくても使えます)

上のコマンドはこれらがなくても動きます。変えたいときだけ作者の説明に沿って追加してください。

  • LAGAAM_ALLOW_ALL_TABLES true にすると、いかなる許可も与えずに実行します。明示的なオプトアウトで、デフォルトではオフです。
    英語の原文を見るtrue to run with no grant at all: an explicit opt-out, off by default
  • LAGAAM_ENGINE Which adapter to run · 初期値 trino
  • TRINO_HOST Trino coordinator のホスト
    英語の原文を見るTrino coordinator host
    · 初期値 localhost
  • TRINO_PORT Trino coordinator のポート
    英語の原文を見るTrino coordinator port
    · 初期値 8080
  • TRINO_USER Trino ユーザー
    英語の原文を見るTrino user
    · 初期値 lagaam
  • TRINO_HTTP_SCHEME http または https。未設定の場合、パスワードまたは JWT が設定されていれば https、そうでなければ http。
    英語の原文を見るhttp or https; unset means https once a password or JWT is set, else http
  • TRINO_VERIFY TLS 証明書チェック: true、false、または CA バンドル(PEM)のパス。
    英語の原文を見るTLS cert check: true, false, or the path of a CA bundle (PEM)
    · 初期値 true
  • PINOT_CONTROLLER_URL Pinot コントローラーの URL。
    英語の原文を見るPinot controller URL
    · 初期値 http://localhost:9000
  • PINOT_BROKER_URL Pinot ブローカーの URL。
    英語の原文を見るPinot broker URL
    · 初期値 http://localhost:8000
  • PINOT_USER Pinot のユーザー名。未設定の場合は認証なしを意味します。
    英語の原文を見るPinot user; unset means no auth
  • LAGAAM_AGENT_NAME 監査証跡に記録される ID
    英語の原文を見るIdentity stamped on the audit trail
    · 初期値 anonymous
  • LAGAAM_MAX_SCAN_BYTES クエリごとのスキャンバイト上限。実行前にチェックされます(デフォルト 50 GiB)。
    英語の原文を見るScan-bytes budget per query, checked before it runs (default 50 GiB)
    · 初期値 53687091200
  • LAGAAM_MAX_ROWS クエリごとのスキャン行数の推定上限。未設定の場合は制限なし。
    英語の原文を見るScanned-row estimate budget per query; unset means ungated
  • LAGAAM_MAX_INTERMEDIATE_ROWS エンジンが最も広いステップで構築する行数であり、返される行数ではありません。そのため LIMIT を指定しても値は下がりません。
    英語の原文を見るRows the engine would build at its widest step, not rows returned, so a LIMIT doesn't lower it
    · 初期値 50000000
  • LAGAAM_MAX_RETURNED_ROWS クエリごとにエージェントへ返される行数で、上限は 100000 です。クエリ内でこれより大きい LIMIT は、この値まで引き下げられます。
    英語の原文を見るRows returned to the agent per query, capped at 100000; a bigger LIMIT in the query is lowered to it
    · 初期値 1000
  • LAGAAM_QUERY_TIMEOUT クエリ 1 回あたりの経過時間(秒)。
    英語の原文を見るWall-clock seconds per query
    · 初期値 300
  • LAGAAM_METADATA_TTL メタデータキャッシュの TTL(秒)
    英語の原文を見るMetadata cache TTL, seconds
    · 初期値 300
  • LAGAAM_AUDIT_LOG 監査 JSONL ファイルのパス。未設定の場合は stderr に出力されます。
    英語の原文を見るAudit JSONL file path; unset means stderr

説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。

メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

ChatGPT はまだ Lagaam につなげません

Lagaam はパソコンに入れて使うものですが、ChatGPT は Web 上で動くサーバーにしかつなげません

代わりにできること

A · Lagaam につなげるアプリを使う

  • Lagaam のキーが必要です(提供元のサイトで作成) · 設定を 1 項目入力 (LAGAAM_ALLOWED_TABLES) · 先にパソコンへ Python (uv) を入れてください(1 回だけ) · パソコン版 Claude アプリ(Windows または Mac)のみ。Web やスマホでは使えません
  • Lagaam のキーが必要です(提供元のサイトで作成) · 設定を 1 項目入力 (LAGAAM_ALLOWED_TABLES) · 先にパソコンへ Python (uv) を入れてください(1 回だけ)
  • Lagaam のキーが必要です(提供元のサイトで作成) · 設定を 1 項目入力 (LAGAAM_ALLOWED_TABLES) · 先にパソコンへ Python (uv) を入れてください(1 回だけ)
  • Lagaam のキーが必要です(提供元のサイトで作成) · 設定を 1 項目入力 (LAGAAM_ALLOWED_TABLES) · 先にパソコンへ Python (uv) を入れてください(1 回だけ)

B · その他 の中で ChatGPT につなげる別のサーバー

同じカテゴリでよく使われているものから、キーなしでアドレスだけでつなげるものを選びました

Claude Code につなげますが、先に準備が必要です

Lagaam のキーが必要です(提供元のサイトで作成) · 設定を 1 項目入力 (LAGAAM_ALLOWED_TABLES) · 先にパソコンへ Python (uv) を入れてください(1 回だけ)

AI にインストールしてもらう

このメッセージを Claude Code のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。

このパソコンの Claude Code に MCP server Lagaam を入れてください。順番に:1) uv --version で uv があるか確認。なければ https://docs.astral.sh/uv/getting-started/installation/ から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):claude mcp add --scope user lagaam --env LAGAAM_ALLOWED_TABLES=your-value --env TRINO_PASSWORD=your-value --env TRINO_JWT=your-value --env PINOT_PASSWORD=your-value -- uvx lagaam 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) TRINO_PASSWORD, TRINO_JWT, PINOT_PASSWORD, LAGAAM_ALLOWED_TABLES は "your-value" のままにして、本当の値は私がファイルかアプリの入力欄に自分で貼るよう伝える。チャットにキーを書かせない。5) 了承した内容を実行し、Lagaam のツールが本当に表示されるか確認する。

このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。

  1. uv を入れる(まだなければ)

    もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter

    uv --version
    • バージョン番号(例 uv …)が出る = 入っています。この手順は飛ばせます
    • "command not found"(Windows では "is not recognized")が出る = まだ入っていないか、入れた直後でターミナルを開き直す必要があります
    ターミナルの開き方

    Mac:⌘ + Space を押し、Terminal と入力して Enter

    Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」

    まだ入っていない場合: uv にはクリック式のインストーラーがありません。uv 公式ページからお使いの OS(macOS か Windows)用の 1 行コマンドをコピーしてターミナルに貼り付けます · Python を別に入れる必要はなく、必要なときに uv が自動で取得します

    uv のダウンロードページを開く ↗

    入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: uv --version

    一度入れれば、uv を使うすべてのツールで使えます

  2. Lagaam に登録してキーを作る

    提供元のサイトで登録し、次の手順で使う API キーを作ります。料金や無料プランは提供元のサイトで確認してください。

    Lagaam のサイトを開く ↗

  3. 設定を 1 項目入力

    これはプログラムの設定でキーではありません。登録は不要で、作者の説明どおりに入力します。

    • LAGAAM_ALLOWED_TABLES カンマ区切りの catalog.schema.table の権限リスト。これがないとサーバーは起動しません。
      英語の原文を見るComma list of catalog.schema.table grants; the server will not start without it

    説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。

  4. ターミナルを開く

    Mac:Command+スペースで Terminal と入力 · Windows:PowerShell を開く

  5. このコマンドを貼り付けて Enter

    claude mcp add --scope user lagaam --env LAGAAM_ALLOWED_TABLES=your-value --env TRINO_PASSWORD=your-value --env TRINO_JWT=your-value --env PINOT_PASSWORD=your-value -- uvx lagaam

    Enter の前に「your-value」を自分のキーに書き換えてください

    キーはアプリの入力欄にだけ貼り付け、チャットに貼ったり人に送ったりしないでください

  6. Claude Code で /mcp と入力

    Lagaam が一覧にあり、接続済みと表示されれば OK です

  7. 試してみる

    Lagaam を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Claude Code が Lagaam を使っていると言うか、回答に Lagaam のツール名が出れば接続成功です

追加の設定 18 項目(入力しなくても使えます)

上のコマンドはこれらがなくても動きます。変えたいときだけ作者の説明に沿って追加してください。

  • LAGAAM_ALLOW_ALL_TABLES true にすると、いかなる許可も与えずに実行します。明示的なオプトアウトで、デフォルトではオフです。
    英語の原文を見るtrue to run with no grant at all: an explicit opt-out, off by default
  • LAGAAM_ENGINE Which adapter to run · 初期値 trino
  • TRINO_HOST Trino coordinator のホスト
    英語の原文を見るTrino coordinator host
    · 初期値 localhost
  • TRINO_PORT Trino coordinator のポート
    英語の原文を見るTrino coordinator port
    · 初期値 8080
  • TRINO_USER Trino ユーザー
    英語の原文を見るTrino user
    · 初期値 lagaam
  • TRINO_HTTP_SCHEME http または https。未設定の場合、パスワードまたは JWT が設定されていれば https、そうでなければ http。
    英語の原文を見るhttp or https; unset means https once a password or JWT is set, else http
  • TRINO_VERIFY TLS 証明書チェック: true、false、または CA バンドル(PEM)のパス。
    英語の原文を見るTLS cert check: true, false, or the path of a CA bundle (PEM)
    · 初期値 true
  • PINOT_CONTROLLER_URL Pinot コントローラーの URL。
    英語の原文を見るPinot controller URL
    · 初期値 http://localhost:9000
  • PINOT_BROKER_URL Pinot ブローカーの URL。
    英語の原文を見るPinot broker URL
    · 初期値 http://localhost:8000
  • PINOT_USER Pinot のユーザー名。未設定の場合は認証なしを意味します。
    英語の原文を見るPinot user; unset means no auth
  • LAGAAM_AGENT_NAME 監査証跡に記録される ID
    英語の原文を見るIdentity stamped on the audit trail
    · 初期値 anonymous
  • LAGAAM_MAX_SCAN_BYTES クエリごとのスキャンバイト上限。実行前にチェックされます(デフォルト 50 GiB)。
    英語の原文を見るScan-bytes budget per query, checked before it runs (default 50 GiB)
    · 初期値 53687091200
  • LAGAAM_MAX_ROWS クエリごとのスキャン行数の推定上限。未設定の場合は制限なし。
    英語の原文を見るScanned-row estimate budget per query; unset means ungated
  • LAGAAM_MAX_INTERMEDIATE_ROWS エンジンが最も広いステップで構築する行数であり、返される行数ではありません。そのため LIMIT を指定しても値は下がりません。
    英語の原文を見るRows the engine would build at its widest step, not rows returned, so a LIMIT doesn't lower it
    · 初期値 50000000
  • LAGAAM_MAX_RETURNED_ROWS クエリごとにエージェントへ返される行数で、上限は 100000 です。クエリ内でこれより大きい LIMIT は、この値まで引き下げられます。
    英語の原文を見るRows returned to the agent per query, capped at 100000; a bigger LIMIT in the query is lowered to it
    · 初期値 1000
  • LAGAAM_QUERY_TIMEOUT クエリ 1 回あたりの経過時間(秒)。
    英語の原文を見るWall-clock seconds per query
    · 初期値 300
  • LAGAAM_METADATA_TTL メタデータキャッシュの TTL(秒)
    英語の原文を見るMetadata cache TTL, seconds
    · 初期値 300
  • LAGAAM_AUDIT_LOG 監査 JSONL ファイルのパス。未設定の場合は stderr に出力されます。
    英語の原文を見るAudit JSONL file path; unset means stderr

説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。

メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

Cursor につなげますが、先に準備が必要です

Lagaam のキーが必要です(提供元のサイトで作成) · 設定を 1 項目入力 (LAGAAM_ALLOWED_TABLES) · 先にパソコンへ Python (uv) を入れてください(1 回だけ)

AI にインストールしてもらう

このメッセージを Cursor のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。

このパソコンの Cursor に MCP server Lagaam を入れてください。順番に:1) uv --version で uv があるか確認。なければ https://docs.astral.sh/uv/getting-started/installation/ から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):{ "mcpServers": { "lagaam": { "command": "uvx", "args": [ "lagaam" ], "env": { "LAGAAM_ALLOWED_TABLES": "your-value", "TRINO_PASSWORD": "your-value", "TRINO_JWT": "your-value", "PINOT_PASSWORD": "your-value" } } } } 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) TRINO_PASSWORD, TRINO_JWT, PINOT_PASSWORD, LAGAAM_ALLOWED_TABLES は "your-value" のままにして、本当の値は私がファイルかアプリの入力欄に自分で貼るよう伝える。チャットにキーを書かせない。5) 了承した内容を実行し、Lagaam のツールが本当に表示されるか確認する。

このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。

  1. uv を入れる(まだなければ)

    もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter

    uv --version
    • バージョン番号(例 uv …)が出る = 入っています。この手順は飛ばせます
    • "command not found"(Windows では "is not recognized")が出る = まだ入っていないか、入れた直後でターミナルを開き直す必要があります
    ターミナルの開き方

    Mac:⌘ + Space を押し、Terminal と入力して Enter

    Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」

    まだ入っていない場合: uv にはクリック式のインストーラーがありません。uv 公式ページからお使いの OS(macOS か Windows)用の 1 行コマンドをコピーしてターミナルに貼り付けます · Python を別に入れる必要はなく、必要なときに uv が自動で取得します

    uv のダウンロードページを開く ↗

    入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: uv --version

    一度入れれば、uv を使うすべてのツールで使えます

  2. Lagaam に登録してキーを作る

    提供元のサイトで登録し、次の手順で使う API キーを作ります。料金や無料プランは提供元のサイトで確認してください。

    Lagaam のサイトを開く ↗

  3. 設定を 1 項目入力

    これはプログラムの設定でキーではありません。登録は不要で、作者の説明どおりに入力します。

    • LAGAAM_ALLOWED_TABLES カンマ区切りの catalog.schema.table の権限リスト。これがないとサーバーは起動しません。
      英語の原文を見るComma list of catalog.schema.table grants; the server will not start without it

    説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。

  4. このボタンで Cursor を開く

    Cursor で開く

    Cursor がインストールの確認をするので Install を押します

  5. キーを入力

    Lagaam の設定で TRINO_PASSWORD, TRINO_JWT, PINOT_PASSWORD, LAGAAM_ALLOWED_TABLES が空です。自分のキーを入れて保存します

    キーはアプリの入力欄にだけ貼り付け、チャットに貼ったり人に送ったりしないでください

  6. Cursor の AI チャットを Agent モードで開く

  7. 試してみる

    Lagaam を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Cursor が Lagaam を使っていると言うか、回答に Lagaam のツール名が出れば接続成功です

追加の設定 18 項目(入力しなくても使えます)

上のコマンドはこれらがなくても動きます。変えたいときだけ作者の説明に沿って追加してください。

  • LAGAAM_ALLOW_ALL_TABLES true にすると、いかなる許可も与えずに実行します。明示的なオプトアウトで、デフォルトではオフです。
    英語の原文を見るtrue to run with no grant at all: an explicit opt-out, off by default
  • LAGAAM_ENGINE Which adapter to run · 初期値 trino
  • TRINO_HOST Trino coordinator のホスト
    英語の原文を見るTrino coordinator host
    · 初期値 localhost
  • TRINO_PORT Trino coordinator のポート
    英語の原文を見るTrino coordinator port
    · 初期値 8080
  • TRINO_USER Trino ユーザー
    英語の原文を見るTrino user
    · 初期値 lagaam
  • TRINO_HTTP_SCHEME http または https。未設定の場合、パスワードまたは JWT が設定されていれば https、そうでなければ http。
    英語の原文を見るhttp or https; unset means https once a password or JWT is set, else http
  • TRINO_VERIFY TLS 証明書チェック: true、false、または CA バンドル(PEM)のパス。
    英語の原文を見るTLS cert check: true, false, or the path of a CA bundle (PEM)
    · 初期値 true
  • PINOT_CONTROLLER_URL Pinot コントローラーの URL。
    英語の原文を見るPinot controller URL
    · 初期値 http://localhost:9000
  • PINOT_BROKER_URL Pinot ブローカーの URL。
    英語の原文を見るPinot broker URL
    · 初期値 http://localhost:8000
  • PINOT_USER Pinot のユーザー名。未設定の場合は認証なしを意味します。
    英語の原文を見るPinot user; unset means no auth
  • LAGAAM_AGENT_NAME 監査証跡に記録される ID
    英語の原文を見るIdentity stamped on the audit trail
    · 初期値 anonymous
  • LAGAAM_MAX_SCAN_BYTES クエリごとのスキャンバイト上限。実行前にチェックされます(デフォルト 50 GiB)。
    英語の原文を見るScan-bytes budget per query, checked before it runs (default 50 GiB)
    · 初期値 53687091200
  • LAGAAM_MAX_ROWS クエリごとのスキャン行数の推定上限。未設定の場合は制限なし。
    英語の原文を見るScanned-row estimate budget per query; unset means ungated
  • LAGAAM_MAX_INTERMEDIATE_ROWS エンジンが最も広いステップで構築する行数であり、返される行数ではありません。そのため LIMIT を指定しても値は下がりません。
    英語の原文を見るRows the engine would build at its widest step, not rows returned, so a LIMIT doesn't lower it
    · 初期値 50000000
  • LAGAAM_MAX_RETURNED_ROWS クエリごとにエージェントへ返される行数で、上限は 100000 です。クエリ内でこれより大きい LIMIT は、この値まで引き下げられます。
    英語の原文を見るRows returned to the agent per query, capped at 100000; a bigger LIMIT in the query is lowered to it
    · 初期値 1000
  • LAGAAM_QUERY_TIMEOUT クエリ 1 回あたりの経過時間(秒)。
    英語の原文を見るWall-clock seconds per query
    · 初期値 300
  • LAGAAM_METADATA_TTL メタデータキャッシュの TTL(秒)
    英語の原文を見るMetadata cache TTL, seconds
    · 初期値 300
  • LAGAAM_AUDIT_LOG 監査 JSONL ファイルのパス。未設定の場合は stderr に出力されます。
    英語の原文を見るAudit JSONL file path; unset means stderr

説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。

メニュー名は 2026年11月11日 に Cursor のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

VS Code につなげますが、先に準備が必要です

Lagaam のキーが必要です(提供元のサイトで作成) · 設定を 1 項目入力 (LAGAAM_ALLOWED_TABLES) · 先にパソコンへ Python (uv) を入れてください(1 回だけ)

AI にインストールしてもらう

このメッセージを VS Code のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。

このパソコンの VS Code に MCP server Lagaam を入れてください。順番に:1) uv --version で uv があるか確認。なければ https://docs.astral.sh/uv/getting-started/installation/ から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):{ "servers": { "lagaam": { "type": "stdio", "command": "uvx", "args": [ "lagaam" ], "env": { "LAGAAM_ALLOWED_TABLES": "your-value", "TRINO_PASSWORD": "your-value", "TRINO_JWT": "your-value", "PINOT_PASSWORD": "your-value" } } } } 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) TRINO_PASSWORD, TRINO_JWT, PINOT_PASSWORD, LAGAAM_ALLOWED_TABLES は "your-value" のままにして、本当の値は私がファイルかアプリの入力欄に自分で貼るよう伝える。チャットにキーを書かせない。5) 了承した内容を実行し、Lagaam のツールが本当に表示されるか確認する。

このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。

  1. uv を入れる(まだなければ)

    もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter

    uv --version
    • バージョン番号(例 uv …)が出る = 入っています。この手順は飛ばせます
    • "command not found"(Windows では "is not recognized")が出る = まだ入っていないか、入れた直後でターミナルを開き直す必要があります
    ターミナルの開き方

    Mac:⌘ + Space を押し、Terminal と入力して Enter

    Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」

    まだ入っていない場合: uv にはクリック式のインストーラーがありません。uv 公式ページからお使いの OS(macOS か Windows)用の 1 行コマンドをコピーしてターミナルに貼り付けます · Python を別に入れる必要はなく、必要なときに uv が自動で取得します

    uv のダウンロードページを開く ↗

    入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: uv --version

    一度入れれば、uv を使うすべてのツールで使えます

  2. Lagaam に登録してキーを作る

    提供元のサイトで登録し、次の手順で使う API キーを作ります。料金や無料プランは提供元のサイトで確認してください。

    Lagaam のサイトを開く ↗

  3. 設定を 1 項目入力

    これはプログラムの設定でキーではありません。登録は不要で、作者の説明どおりに入力します。

    • LAGAAM_ALLOWED_TABLES カンマ区切りの catalog.schema.table の権限リスト。これがないとサーバーは起動しません。
      英語の原文を見るComma list of catalog.schema.table grants; the server will not start without it

    説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。

  4. このボタンで VS Code を開く

    VS Code で開く

    VS Code がインストールの確認をするので Install を押します

  5. キーを入力

    Lagaam の設定で TRINO_PASSWORD, TRINO_JWT, PINOT_PASSWORD, LAGAAM_ALLOWED_TABLES が空です。自分のキーを入れて保存します

    キーはアプリの入力欄にだけ貼り付け、チャットに貼ったり人に送ったりしないでください

  6. VS Code の AI チャットを Agent モードで開く

  7. 試してみる

    Lagaam を使って、私に何ができるか教えて、1 つやってみせて

    ✓ VS Code が Lagaam を使っていると言うか、回答に Lagaam のツール名が出れば接続成功です

追加の設定 18 項目(入力しなくても使えます)

上のコマンドはこれらがなくても動きます。変えたいときだけ作者の説明に沿って追加してください。

  • LAGAAM_ALLOW_ALL_TABLES true にすると、いかなる許可も与えずに実行します。明示的なオプトアウトで、デフォルトではオフです。
    英語の原文を見るtrue to run with no grant at all: an explicit opt-out, off by default
  • LAGAAM_ENGINE Which adapter to run · 初期値 trino
  • TRINO_HOST Trino coordinator のホスト
    英語の原文を見るTrino coordinator host
    · 初期値 localhost
  • TRINO_PORT Trino coordinator のポート
    英語の原文を見るTrino coordinator port
    · 初期値 8080
  • TRINO_USER Trino ユーザー
    英語の原文を見るTrino user
    · 初期値 lagaam
  • TRINO_HTTP_SCHEME http または https。未設定の場合、パスワードまたは JWT が設定されていれば https、そうでなければ http。
    英語の原文を見るhttp or https; unset means https once a password or JWT is set, else http
  • TRINO_VERIFY TLS 証明書チェック: true、false、または CA バンドル(PEM)のパス。
    英語の原文を見るTLS cert check: true, false, or the path of a CA bundle (PEM)
    · 初期値 true
  • PINOT_CONTROLLER_URL Pinot コントローラーの URL。
    英語の原文を見るPinot controller URL
    · 初期値 http://localhost:9000
  • PINOT_BROKER_URL Pinot ブローカーの URL。
    英語の原文を見るPinot broker URL
    · 初期値 http://localhost:8000
  • PINOT_USER Pinot のユーザー名。未設定の場合は認証なしを意味します。
    英語の原文を見るPinot user; unset means no auth
  • LAGAAM_AGENT_NAME 監査証跡に記録される ID
    英語の原文を見るIdentity stamped on the audit trail
    · 初期値 anonymous
  • LAGAAM_MAX_SCAN_BYTES クエリごとのスキャンバイト上限。実行前にチェックされます(デフォルト 50 GiB)。
    英語の原文を見るScan-bytes budget per query, checked before it runs (default 50 GiB)
    · 初期値 53687091200
  • LAGAAM_MAX_ROWS クエリごとのスキャン行数の推定上限。未設定の場合は制限なし。
    英語の原文を見るScanned-row estimate budget per query; unset means ungated
  • LAGAAM_MAX_INTERMEDIATE_ROWS エンジンが最も広いステップで構築する行数であり、返される行数ではありません。そのため LIMIT を指定しても値は下がりません。
    英語の原文を見るRows the engine would build at its widest step, not rows returned, so a LIMIT doesn't lower it
    · 初期値 50000000
  • LAGAAM_MAX_RETURNED_ROWS クエリごとにエージェントへ返される行数で、上限は 100000 です。クエリ内でこれより大きい LIMIT は、この値まで引き下げられます。
    英語の原文を見るRows returned to the agent per query, capped at 100000; a bigger LIMIT in the query is lowered to it
    · 初期値 1000
  • LAGAAM_QUERY_TIMEOUT クエリ 1 回あたりの経過時間(秒)。
    英語の原文を見るWall-clock seconds per query
    · 初期値 300
  • LAGAAM_METADATA_TTL メタデータキャッシュの TTL(秒)
    英語の原文を見るMetadata cache TTL, seconds
    · 初期値 300
  • LAGAAM_AUDIT_LOG 監査 JSONL ファイルのパス。未設定の場合は stderr に出力されます。
    英語の原文を見るAudit JSONL file path; unset means stderr

説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。

メニュー名は 2026年11月11日 に VS Code のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

Windsurf、Zed、Gemini CLI など MCP を使える他のアプリは追加方法がそれぞれ違います。アプリ一覧で確認してください

MCP を使えるアプリをすべて見る →

JSON 設定は下の「開発者向け」にあります

つまずいたら?Lagaam を使っている人に聞いてみましょう💬 ディスカッション →
開発者向け:ターミナルのコマンドと JSON 設定

パソコンにインストール

Claude Code

claude mcp add --scope user lagaam --env LAGAAM_ALLOWED_TABLES=your-value --env TRINO_PASSWORD=your-value --env TRINO_JWT=your-value --env PINOT_PASSWORD=your-value -- uvx lagaam

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "lagaam": {
      "command": "uvx",
      "args": [
        "lagaam"
      ],
      "env": {
        "LAGAAM_ALLOWED_TABLES": "your-value",
        "TRINO_PASSWORD": "your-value",
        "TRINO_JWT": "your-value",
        "PINOT_PASSWORD": "your-value"
      }
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "lagaam": {
      "command": "uvx",
      "args": [
        "lagaam"
      ],
      "env": {
        "LAGAAM_ALLOWED_TABLES": "your-value",
        "TRINO_PASSWORD": "your-value",
        "TRINO_JWT": "your-value",
        "PINOT_PASSWORD": "your-value"
      }
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "lagaam": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "lagaam"
      ],
      "env": {
        "LAGAAM_ALLOWED_TABLES": "your-value",
        "TRINO_PASSWORD": "your-value",
        "TRINO_JWT": "your-value",
        "PINOT_PASSWORD": "your-value"
      }
    }
  }
}

自分で入力する値

  • LAGAAM_ALLOWED_TABLES 必須 env
    カンマ区切りの catalog.schema.table の権限リスト。これがないとサーバーは起動しません。
    英語の原文を見るComma list of catalog.schema.table grants; the server will not start without it
  • LAGAAM_ALLOW_ALL_TABLES env
    true にすると、いかなる許可も与えずに実行します。明示的なオプトアウトで、デフォルトではオフです。
    英語の原文を見るtrue to run with no grant at all: an explicit opt-out, off by default
  • LAGAAM_ENGINE env
    Which adapter to run
  • TRINO_HOST env
    Trino coordinator のホスト
    英語の原文を見るTrino coordinator host
  • TRINO_PORT env
    Trino coordinator のポート
    英語の原文を見るTrino coordinator port
  • TRINO_USER env
    Trino ユーザー
    英語の原文を見るTrino user
  • TRINO_PASSWORD 秘密 必須 env
    TRINO_USER のパスワード。未設定の場合はログインなしを意味します。TRINO_JWT とは併用しません。
    英語の原文を見るPassword for TRINO_USER; unset means no login. Not with TRINO_JWT
  • TRINO_JWT 秘密 必須 env
    パスワードの代わりにログインするための JWT。未設定の場合はログインなし。
    英語の原文を見るJWT to log in with instead of a password; unset means no login
  • TRINO_HTTP_SCHEME env
    http または https。未設定の場合、パスワードまたは JWT が設定されていれば https、そうでなければ http。
    英語の原文を見るhttp or https; unset means https once a password or JWT is set, else http
  • TRINO_VERIFY env
    TLS 証明書チェック: true、false、または CA バンドル(PEM)のパス。
    英語の原文を見るTLS cert check: true, false, or the path of a CA bundle (PEM)
  • PINOT_CONTROLLER_URL env
    Pinot コントローラーの URL。
    英語の原文を見るPinot controller URL
  • PINOT_BROKER_URL env
    Pinot ブローカーの URL。
    英語の原文を見るPinot broker URL
  • PINOT_USER env
    Pinot のユーザー名。未設定の場合は認証なしを意味します。
    英語の原文を見るPinot user; unset means no auth
  • PINOT_PASSWORD 秘密 必須 env
    Pinot のパスワード。未設定の場合は認証なしを意味します。
    英語の原文を見るPinot password; unset means no auth
  • LAGAAM_AGENT_NAME env
    監査証跡に記録される ID
    英語の原文を見るIdentity stamped on the audit trail
  • LAGAAM_MAX_SCAN_BYTES env
    クエリごとのスキャンバイト上限。実行前にチェックされます(デフォルト 50 GiB)。
    英語の原文を見るScan-bytes budget per query, checked before it runs (default 50 GiB)
  • LAGAAM_MAX_ROWS env
    クエリごとのスキャン行数の推定上限。未設定の場合は制限なし。
    英語の原文を見るScanned-row estimate budget per query; unset means ungated
  • LAGAAM_MAX_INTERMEDIATE_ROWS env
    エンジンが最も広いステップで構築する行数であり、返される行数ではありません。そのため LIMIT を指定しても値は下がりません。
    英語の原文を見るRows the engine would build at its widest step, not rows returned, so a LIMIT doesn't lower it
  • LAGAAM_MAX_RETURNED_ROWS env
    クエリごとにエージェントへ返される行数で、上限は 100000 です。クエリ内でこれより大きい LIMIT は、この値まで引き下げられます。
    英語の原文を見るRows returned to the agent per query, capped at 100000; a bigger LIMIT in the query is lowered to it
  • LAGAAM_QUERY_TIMEOUT env
    クエリ 1 回あたりの経過時間(秒)。
    英語の原文を見るWall-clock seconds per query
  • LAGAAM_METADATA_TTL env
    メタデータキャッシュの TTL(秒)
    英語の原文を見るMetadata cache TTL, seconds
  • LAGAAM_AUDIT_LOG env
    監査 JSONL ファイルのパス。未設定の場合は stderr に出力されます。
    英語の原文を見るAudit JSONL file path; unset means stderr

説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。

この設定は、作者のレジストリ登録情報から作成しています。READMEと違う場合は、READMEに従ってください。

ひと目でわかる

週あたりのダウンロードi
122/週
接続方法
パソコンで動く
最新バージョンi
1.0.0
カテゴリi
その他
レジストリ公開日i
2026年11月6日
コードの最終更新i
2026年11月6日
作者
lagaam-ai
パッケージ
pypi: lagaam
ウェブサイト
github.com
レジストリでの状態
有効

使えるアプリ

このサーバーのつなぎ方と、各アプリの公式ドキュメントに基づきます。2026年11月10日に確認。

パソコン上で動かせるアプリ

ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast

すべてのアプリと長所・短所 →

できること

パソコンで動くサーバーです。インストールすると、ツール一覧がAIアプリに表示されます。

基本チェックi

誰でも見られる情報をチェックしており、コードは読んでいません。当てはまらない項目は数に入れていません。 · 2026年11月19日にチェック

  • ✓ 合格

    作者とリポジトリが一致

    レジストリ名は、リポジトリを所有するGitHubアカウント lagaam-ai で確認済みです

  • ✓ 合格

    今もメンテナンスされている

    コードの最終更新:13 日前

  • ✓ 合格

    ライセンスがある

    Apache-2.0を使用

  • – 対象外

    エンドポイントが応答する

    これはパソコンで動くため、インターネット上のエンドポイントはありません

  • – 対象外

    OAuthでサインイン

    パソコンで動き、代わりにローカルの設定を使います

  • … 未チェック

    ツールの説明に隠れた指示がない

    パソコンで動くサーバーです。ツール一覧を読み取れるのは、インターネット上のエンドポイントがある場合だけです

公開済みの脆弱性(OSV.dev)

OSV.dev に lagaam@1.0.0 の登録はありません

このバージョンのパッケージ本体のみ確認。すべての依存関係ではありません · 確認日 2026年11月15日

確認していること → · JSON

作者の方へ:再確認の依頼・情報の誤りの報告
作者向け:README にバッジを付ける

作者の方は、このコードを README に貼れます。バッジはこのページにリンクします。

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/lagaam-ai-lagaam.svg)](https://mcp.popnx.com/en/servers/lagaam-ai-lagaam)

話し合い

質問、コツの共有、使えないことの報告ができます。「役に立った」の多い順です。

まだ投稿はありません。最初の質問や共有をどうぞ。

ここの投稿は利用者によるもので、PopNx チームのものではありません。

ログインして投稿

ユーザーレビュー

まだレビューはありません

ログインしてレビューを書く

その他のほかのサーバーとの比較i

  • このカテゴリのほかの20693件のうち86%よりスターが多い
  • このカテゴリのほかの20693件のうち79%より最近レジストリに公開
  • 基本チェックの結果が、このカテゴリのほかの20693件のうち99%と同じかそれ以上

レジストリでこのカテゴリにある有効なすべてのサーバーと比較しています。スターは、公開者がリポジトリの所有者である場合だけ数えます。

よくある質問

Lagaamは安全ですか?

当てはまる基本チェック3項目のうち3項目に合格しました。コードは読んでいません。キーやトークンを追加する前に、サーバーがどんなアクセスを求めているかを確認し、必要な権限だけを持つキーを使ってください。

どんなキーやコードが必要ですか?

入力が必要なもの:TRINO_PASSWORD, TRINO_JWT, PINOT_PASSWORD

パソコンで動きますか、それともクラウドですか?

あなたのパソコンで動きます。必要なときにAIアプリが起動し、データは作者のサーバーを通りません(サーバー自体がオンラインサービスを呼び出す場合を除きます)。

今もメンテナンスされていますか?

GitHubリポジトリの最終更新は13 日前、最新バージョン(1.0.0)がレジストリに届いたのは13 日前です。

どのアプリで使えますか?

Claude Desktop、Claude Code、Cursor、VS CodeなどのMCP対応アプリで使えます。パソコンにPython (uv)も必要です。

代わりに使えるものは?

同じカテゴリには:World Monitor, openstatus, Oh My Posh Validator, Strata, Jitsu

似た働きのほかの候補

同じカテゴリでほかの作者のもの。コマンドは確認済み。公式を先に、次にスター順。

カードの見方:↓ 週あたりのダウンロードi★ GitHubスターi3つの柱:レビュー · チェック · 利用状況i更新=最新バージョンをレジストリに公開した日i

World Monitor

Real-time global intelligence on conflict, markets, energy, trade, shipping and cyber. 100 tools.

作者:koala73広く使われている★ 9.1万3 日前更新

クラウドで動く✓ 提供元 · worldmonitor.app

openstatus

Manage monitors, status pages, incidents and maintenances in your openstatus workspace.

作者:openstatusHQ広く使われている★ 92742 か月前更新

クラウドで動く✓ 提供元 · openstatus.dev

Oh My Posh Validator

Validate oh-my-posh configurations and segment snippets against the official schema.

作者:JanDeDobbeleer広く使われている★ 2.4万 リポジトリ全体のスター30 日前更新

クラウドで動く✓ 提供元 · ohmyposh.dev

Strata

MCP server for progressive tool usage at any scale (see https://klavis.ai)

作者:Klavis-AI成長中★ 582514 か月前更新

クラウドで動くリポジトリはアーカイブ済み✓ klavis.ai

Jitsu

Manage Jitsu data pipelines: destinations, streams, connections, functions, live events.

作者:jitsucom広く使われている★ 51364 か月前更新

クラウドで動く✓ 提供元 · jitsu.com
似たものと比べる
これ
Lagaam
World MonitoropenstatusOh My Posh ValidatorStrataJitsu
動く場所パソコンにインストールが必要クラウドで動き、インストール不要クラウドで動き、インストール不要クラウドで動き、インストール不要クラウドで動き、インストール不要クラウドで動き、インストール不要
キーが必要はいいいえいいえいいえいいえいいえ
Claude で + から追加いいえいいえいいえいいえいいえいいえ
基本チェック3/34/44/44/41/44/4
ライセンスApache-2.0AGPL-3.0AGPL-3.0MITApache-2.0MIT
料金登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし

作者のREADME

READMEを開く

作者のリポジトリから書かれたとおりにコピーしたものです。PopNx MCPは内容を確認・推奨していません。HTML、画像、スクリプトは取り除いています。リンクはこのサイトの外へ移動します。

One agent query shouldn't stall everyone's Trino. On a shared cluster, a missing partition filter or an accidental cross join doesn't cost you a bill — it costs everyone else their queries. Lagaam is an MCP server that sits between your AI agents and your lakehouse (Trino and Apache Pinot): every query is schema-grounded, priced from the engine's own plan *before* it runs, checked against a budget, and audited — and the bad one is refused before it runs, with a fix the agent can act on.

*Real session, real Trino, nothing mocked — reproduce it with uv run --project server python examples/demo.py.*

*Real session, real Pinot 1.5.1 realtime table, nothing mocked — reproduce it with uv run --project server python examples/demo_pinot.py.*

The problem

Agents write syntactically-valid, catastrophic SQL, and on a shared cluster the damage isn't theirs alone. A missing partition filter turns into a full scan that ties up every worker; an accidental cross join fills worker memory while everyone else's queries wait behind it; a retry loop runs it again. A SELECT * drags 40 columns into a context window that needed 2. The usual fix is to not give agents database access at all.

Lagaam gives them access with reins on:

  • Cost is a quotation, not a bill. Every query is priced from the engine's own plan before execution — EXPLAIN (TYPE IO) for the bytes it would scan, EXPLAIN (TYPE LOGICAL) for the widest row count any operator would build (the number a cross join blows and a LIMIT cannot hide). Over budget → blocked, with the number and the fix.
  • Un-estimable means no. No table statistics, a self-join that breaks the estimate, a passthrough the planner can't see — the gate fails safe instead of hoping.
  • Read-only, enforced in the AST. Single SELECT only. No DDL/DML, no multi-statement injection, no SELECT *, no table-function passthrough, and a LIMIT is injected when missing. Validated SQL is re-rendered, so what runs is exactly what was checked.
  • Agents ground themselves. list_catalogs and describe_table return exact names, types, and row estimates — scoped to the agent's table grant, so the agent never learns names it isn't allowed to touch.
  • Results are verified before they're trusted. Zero rows, truncated pages, all-NULL columns — the agent gets a warning with a next action, not a silently misleading answer.
  • Every call is audited. One JSONL line per tool call: who, what, allowed or denied, and why. A query's line puts the quote next to what the engine says it actually read, so you can see how far off the estimate was before you loosen or tighten a budget.

Doesn't Trino already limit this?

It limits a query once it is running. Lagaam refuses it before it starts. Keep both.

ActsWhat the agent seesCatches a cross join that reads little
query.max-scan-physical-bytesduring execution: terminated once the bytes are scanneda query failureno — it counts bytes read, not rows built
query.max-execution-timeduring execution: terminated after the time is spenta query failureonly after it has held the cluster that long
Resource groups (hardPhysicalDataScanLimit, softMemoryLimit, …)on the *next* query: new queries queue once the group is over its shareits later queries waitno — the running query continues
Lagaambefore execution, from EXPLAINa refusal with the number and the fixyes — it prices the rows the widest step would build

Measured on Trino 476: SELECT o.orderkey, l.partkey FROM tpch.tiny.orders o CROSS JOIN tpch.tiny.lineitem l LIMIT 10 reads 676,575 bytes by Trino's own plan — any scan cap above 0.7 MB lets it run — and would build 902,625,000 rows. Lagaam refuses it before it runs: *"This query would build 902,625,000 rows at its widest step, over your budget of 50,000,000 … a LIMIT will not help — join on a column with more distinct values, or filter each side before the join."*

Resource groups stay your backstop for everything that does reach the cluster; Lagaam is the gate in front of it for agent traffic.

What about other database MCP servers?

They're good servers that do a different job: keep the agent read-only and bound what comes back. Lagaam does that too, and also prices the query first.

Read-onlyRow capTimeoutChecks the plan before running
tuannvm/mcp-trinoon by defaultresults truncated while fetching (TRINO_MAX_ROWS)during execution (TRINO_QUERY_TIMEOUT)no — explain_query shows the agent a plan; it doesn't gate execute_query
startreedata/mcp-pinotalways on, parsed before executionLIMIT rewritten before execution, paged resultsduring execution (PINOT_QUERY_TIMEOUT, 60 s)no
bytebase/dbhubopt-in (readonly): keyword check plus the database's own read-only transactionopt-in (max_rows), injected as LIMIT/TOPopt-in (query_timeout), during executionno — opt-in explain_sql shows a plan; it doesn't gate execute_sql
Lagaamalways on, parsed before execution1,000 by default; a bigger LIMIT is lowered before it runsduring execution (LAGAAM_QUERY_TIMEOUT, 300 s)yes — scan bytes and widest-step rows from EXPLAIN; over budget is refused

Catch rate

11 queries an LLM agent plausibly writes — full scans, SELECT *, DDL, injection attempts, oversized joins, out-of-grant reads. A raw MCP wrapper submits all of them to the engine. Lagaam stops 11/11 before execution while the well-scoped control query runs untouched. Reproduce: benchmarks/catch_rate.py → results.

Quickstart

Against the Trino you already have (TRINO_PORT / TRINO_USER if yours aren't 8080 / lagaam):

TRINO_HOST=trino.internal LAGAAM_ALLOWED_TABLES=hive.sales.orders uvx lagaam   # MCP server on stdio

Or try it on a demo warehouse:

git clone https://github.com/lagaam-ai/lagaam && cd lagaam

docker compose -f examples/docker-compose.yml --profile trino up -d # demo warehouse cd server && uv sync LAGAAM_ALLOWED_TABLES=tpch.tiny.orders,tpch.tiny.lineitem \ uv run python -m lagaam # MCP server on stdio

For Pinot, --profile pinot brings up the batch quickstart and --profile pinot-realtime up -d brings up a Kafka-fed streaming one — run examples/pinot-realtime/bootstrap.sh after it to create the topics, tables and feed. Then start the server with LAGAAM_ENGINE=pinot.

Wire it into any MCP client (Claude Code, Claude Desktop, or your own agent):

{

"mcpServers": { "lagaam": { "command": "uvx", "args": ["lagaam"], "env": { "TRINO_HOST": "localhost", "LAGAAM_MAX_SCAN_BYTES": "5368709120", "LAGAAM_ALLOWED_TABLES": "hive.sales.orders,hive.sales.customers" } } } }

In Claude Code, install it as a plugin instead:

/plugin marketplace add lagaam-ai/lagaam

/plugin install lagaam@lagaam

It asks for the tables to allow (LAGAAM_ALLOWED_TABLES) and your Trino host, port and user (localhost / 8080 / lagaam if you leave them). From a shell, pass them as flags:

claude plugin marketplace add lagaam-ai/lagaam

claude plugin install lagaam@lagaam \ --config allowed_tables=hive.sales.orders --config trino_host=trino.internal

On Pinot, pick engine=pinot and set the controller and broker URLs (http://localhost:9000 / http://localhost:8000 if you leave them):

claude plugin install lagaam@lagaam --config engine=pinot \

--config allowed_tables=pinot.default.baseballStats \ --config pinot_controller_url=http://pinot.internal:9000 \ --config pinot_broker_url=http://pinot.internal:8099

Other LAGAAM_* settings, the Trino login (TRINO_PASSWORD or TRINO_JWT, plus TRINO_VERIFY for a private CA), and PINOT_USER / PINOT_PASSWORD for a Pinot with auth, are read from the environment you start claude in, so a password never sits in the plugin's config.

The agent gets three tools — list_catalogs, describe_table, query_data — and cannot reach the engine any other way.

Configuration

Env varMeaningDefault
LAGAAM_ALLOWED_TABLESComma list of catalog.schema.table grantsrequired
LAGAAM_ALLOW_ALL_TABLEStrue to run with no grant at alloff
LAGAAM_AGENT_NAMEIdentity stamped on the audit trailanonymous
LAGAAM_MAX_SCAN_BYTESScan-bytes budget per query, pre-execution50 GiB
LAGAAM_MAX_ROWSScanned-row estimate budget per queryungated
LAGAAM_MAX_INTERMEDIATE_ROWSRows the engine would *build* at its widest step — not rows returned, so a LIMIT doesn't lower it50,000,000
LAGAAM_MAX_RETURNED_ROWSRows returned to the agent per query — unset, the server applies its own 1000-row cap, and a bigger LIMIT in the query is lowered to it before it runs1000 (max 100000)
LAGAAM_QUERY_TIMEOUTWall-clock seconds per query300
LAGAAM_METADATA_TTLMetadata cache TTL, seconds300
LAGAAM_AUDIT_LOGAudit JSONL file pathstderr
LAGAAM_ENGINEpinot to run the native Pinot adaptertrino
PINOT_CONTROLLER_URL / PINOT_BROKER_URLPinot controller and brokerhttp://localhost:9000 / http://localhost:8000
PINOT_USER / PINOT_PASSWORDBasic-auth login for Pinotunset (no login)
TRINO_HOST / TRINO_PORT / TRINO_USERTrino coordinatorlocalhost / 8080 / lagaam
TRINO_PASSWORDPassword for TRINO_USER, for a cluster that wants a loginunset (no login)
TRINO_JWTJWT to log in with instead of a password — set one or the other, not bothunset
TRINO_HTTP_SCHEMEhttp or httpshttps once a password or JWT is set, else http
TRINO_VERIFYCheck the cluster's TLS cert: true, false, or the path of your CA bundle (PEM) for a private CAtrue

A shared Trino with a login works the same way. Set TRINO_PASSWORD (or TRINO_JWT) and lagaam talks https, since Trino won't take a password over plain http; set TRINO_PORT to the cluster's https port too (often 443 or 8443). A login the cluster refuses tells the agent so, without the password, and a password and a JWT both set stop the server at startup rather than guessing which one you meant. Try it locally against a Trino that wants both: examples/trino-auth/setup.sh, then docker compose -f examples/docker-compose.yml --profile trino-auth up -d.

The server will not start without `LAGAAM_ALLOWED_TABLES`. An agent that can reach every table in every catalog is the thing this exists to prevent, so that has to be asked for — set LAGAAM_ALLOW_ALL_TABLES=true if you mean it.

The budget dimensions above apply whether or not you set them. Leaving LAGAAM_MAX_SCAN_BYTES and LAGAAM_MAX_INTERMEDIATE_ROWS unset gives you their defaults, not an open gate — an unconfigured server refuses what it cannot afford rather than waving it through. If queries are being denied and you expected no limits, that is why; raise the dimension you mean to raise.

Cost quotes come from the engine's own plan estimates, and those need tab

冒頭だけを表示しています。続きはリポジトリで読めます