Prototyp · Vorschau: alle Server aus der offiziellen Registry, alle 30 Minuten synchronisiert. Mit Google anmelden, um Bewertungen zu schreiben.Prototyp · alle 30 Min. aktualisiert
PopNx MCPMCP-Server für alle, die KI nutzen · in einfachen Worten erklärt

AKKO MCP server for Trino

von AKKO-pVersion 0.8.0i★ 7 (Sterne gehören zu einem anderen Repo)iLäuft auf deinem Computer
Name in der Registryio.github.ab2dridi/akko-mcp-trino

So installierst du es

What it does

Read-only MCP server for Trino: queries run as the verified user, and Trino's own policies decide.

  • Connects Läuft auf deinem Computer
  • Account or key Needs TRINO_HOST, TRINO_HTTP_SCHEME, MCP_JWKS_URL, MCP_OIDC_ISSUER, MCP_OIDC_AUDIENCE, TRINO_TOKEN_EXCHANGE_CLIENT_SECRET, MCP_USER_TOKEN
  • Category Sonstiges

Installation

Wähle die KI-App, die du nutzt, und kopiere die Einstellungen.

2/3 Prüfungen bestanden · Läuft auf deinem Computer · ✓ Befehle geprüft am 13. Nov. 2026

Zuerst: Welche KI nutzt du?

Wähle deine App, dann erscheinen die Schritte unten.

Klappt mit Claude, aber erst etwas vorbereiten

Du brauchst einen Schlüssel von AKKO MCP server for Trino (auf der Seite des Anbieters erstellen) · Installiere zuerst Python (uv) auf deinem Computer (nur einmal) · Nur in der Claude-App für den Computer (Windows oder Mac), nicht im Web oder auf dem Handy

  1. Python (uv) installieren

    Nur einmal; gilt für alle Server, die Python (uv) brauchen

    Download-Seite von Python (uv) öffnen ↗

  2. Bei AKKO MCP server for Trino registrieren und Schlüssel erstellen

    Öffne die Seite des Anbieters, registriere dich und erstelle einen API-Schlüssel für den nächsten Schritt. Preise und Gratis-Tarife siehst du auf seiner Seite.

    Seite von AKKO MCP server for Trino öffnen ↗

  3. Einstellungsdatei der Claude-Desktop-App öffnen

    SettingsDeveloperEdit Config

  4. Diese Einstellungen einfügen und speichern

    {
      "mcpServers": {
        "akko-trino": {
          "command": "uvx",
          "args": [
            "akko-mcp-trino"
          ],
          "env": {
            "TRINO_HOST": "your-value",
            "TRINO_HTTP_SCHEME": "your-value",
            "MCP_JWKS_URL": "your-value",
            "MCP_OIDC_ISSUER": "your-value",
            "MCP_OIDC_AUDIENCE": "your-value",
            "TRINO_TOKEN_EXCHANGE_URL": "your-value",
            "TRINO_TOKEN_EXCHANGE_CLIENT_ID": "your-value",
            "TRINO_TOKEN_EXCHANGE_CLIENT_SECRET": "your-value",
            "TRINO_TOKEN_EXCHANGE_AUDIENCE": "your-value",
            "TRINO_IDENTITY_MODE": "your-value",
            "MCP_USER_TOKEN": "your-value"
          }
        }
      }
    }

    Füge den Schlüssel nur in das Feld der App ein, nie in einen Chat und schick ihn niemandem

  5. Claude beenden und neu öffnen

  6. Ausprobieren

    Nutze AKKO MCP server for Trino und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn Claude sagt, dass es AKKO MCP server for Trino nutzt, oder ein Werkzeug von AKKO MCP server for Trino in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von Anthropic abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

ChatGPT kann AKKO MCP server for Trino noch nicht verbinden

AKKO MCP server for Trino läuft auf deinem Computer, aber ChatGPT verbindet nur Server, die im Web laufen

Das kannst du stattdessen tun

A · Eine App nutzen, die AKKO MCP server for Trino verbinden kann

  • Du brauchst einen Schlüssel von AKKO MCP server for Trino (auf der Seite des Anbieters erstellen) · Installiere zuerst Python (uv) auf deinem Computer (nur einmal) · Nur in der Claude-App für den Computer (Windows oder Mac), nicht im Web oder auf dem Handy
  • Du brauchst einen Schlüssel von AKKO MCP server for Trino (auf der Seite des Anbieters erstellen) · Installiere zuerst Python (uv) auf deinem Computer (nur einmal)
  • Du brauchst einen Schlüssel von AKKO MCP server for Trino (auf der Seite des Anbieters erstellen) · Installiere zuerst Python (uv) auf deinem Computer (nur einmal)
  • Du brauchst einen Schlüssel von AKKO MCP server for Trino (auf der Seite des Anbieters erstellen) · Installiere zuerst Python (uv) auf deinem Computer (nur einmal)

B · Andere in Sonstiges, die mit ChatGPT funktionieren

Aus den meistgenutzten derselben Kategorie, nur solche, die per Adresse ohne Schlüssel verbinden

Klappt mit Claude Code, aber erst etwas vorbereiten

Du brauchst einen Schlüssel von AKKO MCP server for Trino (auf der Seite des Anbieters erstellen) · Installiere zuerst Python (uv) auf deinem Computer (nur einmal)

  1. Python (uv) installieren

    Nur einmal; gilt für alle Server, die Python (uv) brauchen

    Download-Seite von Python (uv) öffnen ↗

  2. Bei AKKO MCP server for Trino registrieren und Schlüssel erstellen

    Öffne die Seite des Anbieters, registriere dich und erstelle einen API-Schlüssel für den nächsten Schritt. Preise und Gratis-Tarife siehst du auf seiner Seite.

    Seite von AKKO MCP server for Trino öffnen ↗

  3. Terminal öffnen

    Mac: Command+Leertaste drücken und Terminal tippen · Windows: PowerShell öffnen

  4. Diesen Befehl einfügen und Enter drücken

    claude mcp add --scope user akko-trino --env TRINO_HOST=your-value --env TRINO_HTTP_SCHEME=your-value --env MCP_JWKS_URL=your-value --env MCP_OIDC_ISSUER=your-value --env MCP_OIDC_AUDIENCE=your-value --env TRINO_TOKEN_EXCHANGE_URL=your-value --env TRINO_TOKEN_EXCHANGE_CLIENT_ID=your-value --env TRINO_TOKEN_EXCHANGE_CLIENT_SECRET=your-value --env TRINO_TOKEN_EXCHANGE_AUDIENCE=your-value --env TRINO_IDENTITY_MODE=your-value --env MCP_USER_TOKEN=your-value -- uvx akko-mcp-trino

    Ersetze „your-value“ vor dem Enter durch deinen Schlüssel

    Füge den Schlüssel nur in das Feld der App ein, nie in einen Chat und schick ihn niemandem

  5. /mcp in Claude Code eingeben

    AKKO MCP server for Trino sollte in der Liste als verbunden erscheinen

  6. Ausprobieren

    Nutze AKKO MCP server for Trino und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn Claude Code sagt, dass es AKKO MCP server for Trino nutzt, oder ein Werkzeug von AKKO MCP server for Trino in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von Anthropic abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Klappt mit Cursor, aber erst etwas vorbereiten

Du brauchst einen Schlüssel von AKKO MCP server for Trino (auf der Seite des Anbieters erstellen) · Installiere zuerst Python (uv) auf deinem Computer (nur einmal)

  1. Python (uv) installieren

    Nur einmal; gilt für alle Server, die Python (uv) brauchen

    Download-Seite von Python (uv) öffnen ↗

  2. Bei AKKO MCP server for Trino registrieren und Schlüssel erstellen

    Öffne die Seite des Anbieters, registriere dich und erstelle einen API-Schlüssel für den nächsten Schritt. Preise und Gratis-Tarife siehst du auf seiner Seite.

    Seite von AKKO MCP server for Trino öffnen ↗

  3. Mit diesem Button Cursor öffnen

    In Cursor öffnen

    Cursor fragt nach einer Bestätigung; klicke Install

  4. Schlüssel eintragen

    In den Einstellungen von AKKO MCP server for Trino ist TRINO_HOST, TRINO_HTTP_SCHEME, MCP_JWKS_URL, MCP_OIDC_ISSUER, MCP_OIDC_AUDIENCE, TRINO_TOKEN_EXCHANGE_URL, TRINO_TOKEN_EXCHANGE_CLIENT_ID, TRINO_TOKEN_EXCHANGE_CLIENT_SECRET, TRINO_TOKEN_EXCHANGE_AUDIENCE, TRINO_IDENTITY_MODE, MCP_USER_TOKEN leer; trag deinen Schlüssel ein und speichere

    Füge den Schlüssel nur in das Feld der App ein, nie in einen Chat und schick ihn niemandem

  5. KI-Chat in Cursor im Agent-Modus öffnen

  6. Ausprobieren

    Nutze AKKO MCP server for Trino und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn Cursor sagt, dass es AKKO MCP server for Trino nutzt, oder ein Werkzeug von AKKO MCP server for Trino in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von Cursor abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Klappt mit VS Code, aber erst etwas vorbereiten

Du brauchst einen Schlüssel von AKKO MCP server for Trino (auf der Seite des Anbieters erstellen) · Installiere zuerst Python (uv) auf deinem Computer (nur einmal)

  1. Python (uv) installieren

    Nur einmal; gilt für alle Server, die Python (uv) brauchen

    Download-Seite von Python (uv) öffnen ↗

  2. Bei AKKO MCP server for Trino registrieren und Schlüssel erstellen

    Öffne die Seite des Anbieters, registriere dich und erstelle einen API-Schlüssel für den nächsten Schritt. Preise und Gratis-Tarife siehst du auf seiner Seite.

    Seite von AKKO MCP server for Trino öffnen ↗

  3. Mit diesem Button VS Code öffnen

    In VS Code öffnen

    VS Code fragt nach einer Bestätigung; klicke Install

  4. Schlüssel eintragen

    In den Einstellungen von AKKO MCP server for Trino ist TRINO_HOST, TRINO_HTTP_SCHEME, MCP_JWKS_URL, MCP_OIDC_ISSUER, MCP_OIDC_AUDIENCE, TRINO_TOKEN_EXCHANGE_URL, TRINO_TOKEN_EXCHANGE_CLIENT_ID, TRINO_TOKEN_EXCHANGE_CLIENT_SECRET, TRINO_TOKEN_EXCHANGE_AUDIENCE, TRINO_IDENTITY_MODE, MCP_USER_TOKEN leer; trag deinen Schlüssel ein und speichere

    Füge den Schlüssel nur in das Feld der App ein, nie in einen Chat und schick ihn niemandem

  5. KI-Chat in VS Code im Agent-Modus öffnen

  6. Ausprobieren

    Nutze AKKO MCP server for Trino und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn VS Code sagt, dass es AKKO MCP server for Trino nutzt, oder ein Werkzeug von AKKO MCP server for Trino in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von VS Code abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Andere Apps mit MCP, etwa Windsurf, Zed oder Gemini CLI, fügen Server unterschiedlich hinzu. Sieh in der App-Liste nach

Alle Apps mit MCP ansehen →

JSON-Einstellungen stehen unten unter „Für Entwickler“

Hängst du fest? Frag Leute, die AKKO MCP server for Trino nutzen💬 Diskussion →
Für Entwickler: Terminal-Befehle und JSON-Einstellungen

Auf deinem Computer installiert

Claude Code

claude mcp add --scope user akko-trino --env TRINO_HOST=your-value --env TRINO_HTTP_SCHEME=your-value --env MCP_JWKS_URL=your-value --env MCP_OIDC_ISSUER=your-value --env MCP_OIDC_AUDIENCE=your-value --env TRINO_TOKEN_EXCHANGE_URL=your-value --env TRINO_TOKEN_EXCHANGE_CLIENT_ID=your-value --env TRINO_TOKEN_EXCHANGE_CLIENT_SECRET=your-value --env TRINO_TOKEN_EXCHANGE_AUDIENCE=your-value --env TRINO_IDENTITY_MODE=your-value --env MCP_USER_TOKEN=your-value -- uvx akko-mcp-trino

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "akko-trino": {
      "command": "uvx",
      "args": [
        "akko-mcp-trino"
      ],
      "env": {
        "TRINO_HOST": "your-value",
        "TRINO_HTTP_SCHEME": "your-value",
        "MCP_JWKS_URL": "your-value",
        "MCP_OIDC_ISSUER": "your-value",
        "MCP_OIDC_AUDIENCE": "your-value",
        "TRINO_TOKEN_EXCHANGE_URL": "your-value",
        "TRINO_TOKEN_EXCHANGE_CLIENT_ID": "your-value",
        "TRINO_TOKEN_EXCHANGE_CLIENT_SECRET": "your-value",
        "TRINO_TOKEN_EXCHANGE_AUDIENCE": "your-value",
        "TRINO_IDENTITY_MODE": "your-value",
        "MCP_USER_TOKEN": "your-value"
      }
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "akko-trino": {
      "command": "uvx",
      "args": [
        "akko-mcp-trino"
      ],
      "env": {
        "TRINO_HOST": "your-value",
        "TRINO_HTTP_SCHEME": "your-value",
        "MCP_JWKS_URL": "your-value",
        "MCP_OIDC_ISSUER": "your-value",
        "MCP_OIDC_AUDIENCE": "your-value",
        "TRINO_TOKEN_EXCHANGE_URL": "your-value",
        "TRINO_TOKEN_EXCHANGE_CLIENT_ID": "your-value",
        "TRINO_TOKEN_EXCHANGE_CLIENT_SECRET": "your-value",
        "TRINO_TOKEN_EXCHANGE_AUDIENCE": "your-value",
        "TRINO_IDENTITY_MODE": "your-value",
        "MCP_USER_TOKEN": "your-value"
      }
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "akko-trino": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "akko-mcp-trino"
      ],
      "env": {
        "TRINO_HOST": "your-value",
        "TRINO_HTTP_SCHEME": "your-value",
        "MCP_JWKS_URL": "your-value",
        "MCP_OIDC_ISSUER": "your-value",
        "MCP_OIDC_AUDIENCE": "your-value",
        "TRINO_TOKEN_EXCHANGE_URL": "your-value",
        "TRINO_TOKEN_EXCHANGE_CLIENT_ID": "your-value",
        "TRINO_TOKEN_EXCHANGE_CLIENT_SECRET": "your-value",
        "TRINO_TOKEN_EXCHANGE_AUDIENCE": "your-value",
        "TRINO_IDENTITY_MODE": "your-value",
        "MCP_USER_TOKEN": "your-value"
      }
    }
  }
}

Werte, die du selbst einträgst

  • TRINO_HOST erforderlich env
    Trino coordinator host
  • TRINO_HTTP_SCHEME erforderlich env
    https (required by the default identity mode)
  • MCP_JWKS_URL erforderlich env
    JWKS endpoint of the OIDC provider
  • MCP_OIDC_ISSUER erforderlich env
    Expected token issuer
  • MCP_OIDC_AUDIENCE erforderlich env
    The audience of tokens issued for this server (never Trino's)
  • TRINO_TOKEN_EXCHANGE_URL env
    Token endpoint for OAuth 2.0 Token Exchange (jwt mode)
  • TRINO_TOKEN_EXCHANGE_CLIENT_ID env
    This server's client at the provider (jwt mode)
  • TRINO_TOKEN_EXCHANGE_CLIENT_SECRET geheim env
    Its secret (jwt mode)
  • TRINO_TOKEN_EXCHANGE_AUDIENCE env
    The audience Trino accepts (jwt mode)
  • TRINO_IDENTITY_MODE env
    jwt (default), impersonation, oauth2 (Trino browser login, stdio only; needs the door open, MCP_AUTH_REQUIRED=false, or a verified MCP_USER_TOKEN), or service
  • MCP_USER_TOKEN geheim erforderlich env
    The user's bearer token, issued for this server (stdio transport)

Diese Einstellungen werden aus dem Registry-Eintrag des Entwicklers erzeugt. Wenn in der README etwas anderes steht, folge der README.

Auf einen Blick

GitHub-Sternei
7 (Sterne gehören zu einem anderen Repo)
Dieser Eintrag verweist auf das Repo einer anderen Person, daher zählen die Sterne nicht in Ranglisten
Downloads pro Wochei
196/Wo.
Lizenzi
Apache-2.0
Verbindung
Läuft auf deinem Computer
Neueste Versioni
0.8.0
Kategoriei
Sonstiges
In der Registry veröffentlichti
13. Nov. 2026
Code zuletzt geänderti
13. Nov. 2026
Entwickler
AKKO-p
Pakete
pypi: akko-mcp-trino
Registry-Status
Aktiv

Welche Apps ihn nutzen können

Basierend darauf, wie sich dieser Server verbindet, und auf der eigenen Doku jeder App, geprüft am 10. Nov. 2026.

Laufen auf deinem Computer in

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

Alle Apps, mit Vor- und Nachteilen →

Was er kann

Läuft auf deinem Computer; die Tool-Liste erscheint nach der Installation in deiner KI-App.

Basischecksi

Wir prüfen Informationen, die jeder sehen kann; den Code haben wir nicht gelesen. Checks, die nicht zutreffen, werden nicht mitgezählt. · Geprüft am 14. Nov. 2026

  • ! Vorsicht

    Entwickler passt zum Repo

    Der Herausgeber (ab2dridi) ist nicht der Repo-Inhaber (AKKO-p); vielleicht hat jemand anderes ihn eingetragen

  • ✓ Bestanden

    Wird noch gepflegt

    Code zuletzt geändert: gestern

  • ✓ Bestanden

    Hat eine Lizenz

    Nutzt Apache-2.0

  • – Nicht zutreffend

    Endpunkt antwortet

    Dieser Server läuft auf deinem Computer; es gibt keinen Endpunkt im Internet

  • – Nicht zutreffend

    Anmeldung mit OAuth

    Läuft auf deinem Computer und nutzt stattdessen lokale Einstellungen

  • … Noch nicht geprüft

    Keine versteckten Anweisungen in Tool-Beschreibungen

    Läuft auf deinem Computer; Tool-Listen können wir nur von Endpunkten im Internet lesen

Diskussion

Fragen, Tipps teilen oder melden, dass etwas nicht geht. Sortiert nach „hilfreich“.

Noch keine Beiträge. Stell die erste Frage oder teile einen Tipp.

Beiträge hier stammen von Nutzern, nicht vom PopNx-Team.

Mit Google anmelden, um zu posten

Nutzerbewertungen

Noch keine Bewertungen

Mit Google anmelden, um zu bewerten

Im Vergleich mit anderen in Sonstigesi

  • Mehr Sterne als 0 % der anderen 19704 Server in dieser Kategorie
  • Neuer in der Registry veröffentlicht als 95 % der anderen 19704 Server in dieser Kategorie
  • Basischecks gleich gut wie oder besser als bei 44 % der anderen 19704 Server in dieser Kategorie

Verglichen mit allen aktiven Servern dieser Kategorie in der Registry. Sterne zählen nur, wenn dem Herausgeber das Repo gehört.

Häufige Fragen

Ist AKKO MCP server for Trino sicher?

Er hat 2 von 3 zutreffenden Basischecks bestanden. Den Code haben wir nicht gelesen. Bevor du einen Schlüssel oder Token hinzufügst, sieh nach, welche Zugriffe der Server verlangt, und nutze einen Schlüssel, der nur die Berechtigungen hat, die du brauchst.

Welche Schlüssel oder Codes braucht er?

Das musst du eintragen: TRINO_HOST, TRINO_HTTP_SCHEME, MCP_JWKS_URL, MCP_OIDC_ISSUER, MCP_OIDC_AUDIENCE, TRINO_TOKEN_EXCHANGE_CLIENT_SECRET, MCP_USER_TOKEN

Läuft er auf meinem Computer oder in der Cloud?

Er läuft auf deinem Computer. Deine KI-App startet ihn bei Bedarf, und die Daten laufen nicht über die Server des Entwicklers (außer der Server ruft selbst einen Onlinedienst auf).

Wird er noch gepflegt?

Das GitHub-Repo wurde zuletzt gestern geändert, und die neueste Version (0.8.0) kam gestern in die Registry.

Welche Apps können ihn nutzen?

Apps, die MCP unterstützen, etwa Claude Desktop, Claude Code, Cursor und VS Code. Außerdem brauchst du Python (uv) auf deinem Computer.

Was kann ich stattdessen nutzen?

In derselben Kategorie: World Monitor, Claude Flow, Windmill

Andere in derselben Kategorie

Server derselben Kategorie von anderen Entwicklern, sortiert nach Sternen.

So liest du eine Karte:↓ Downloads pro Wochei★ GitHub-SterneiDrei Säulen: Bewertungen · Checks · NutzungiAktualisiert = neueste Version in der Registry veröffentlichti

World Monitor

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

von koala73Weit verbreitet★ 90.571Aktualisiert gestern

Läuft in der Cloud✓ vom Dienst · worldmonitor.app

Claude Flow

AI orchestration with hive-mind swarms, neural networks, and 87 MCP tools for enterprise dev.

von ruvnetWeit verbreitet↓ 13.513/Wo.★ 81.591Aktualisiert vor 14 Monaten

Läuft auf deinem Computer

Windmill

Run Windmill scripts and flows and manage jobs, schedules, resources and variables.

von windmill-labsWeit verbreitet★ 18.572Aktualisiert vorgestern

Läuft in der Cloud

README vom Entwickler

README öffnen

Unverändert aus dem Repo des Entwicklers übernommen. PopNx MCP hat den Inhalt weder geprüft noch empfiehlt es ihn. HTML, Bilder und Skripte wurden entfernt. Links führen von dieser Website weg.

akko-mcp-trino

English · Français

Give your AI agents read-only access to Trino, and nothing more.

akko-mcp-trino is an MCP server for Trino. An agent can use it to find tables and columns, describe a schema or a table, list catalogs, schemas and tables, and explain or run a query. The server parses every statement and refuses any write before it reaches Trino. By default, each query runs as the user the agent acts for. The server verifies the user's token, which must be issued for this server. It then obtains a separate token for Trino from the identity provider (OAuth 2.0 Token Exchange). The user's own token never leaves the server. Trino's access control (OPA, Ranger, or Trino's own rules) then decides what that user may read. Results are limited in rows and in time, and every call leaves one audit line.

Upgrading from 0.7.0? 0.7.1 and 0.7.2 are security releases. execute_query refuses

SHOW STATS, EXPLAIN, SHOW CREATE and the other reads listed in

Security, and the user is read from sub.

With Keycloak, set MCP_JWT_USER_CLAIM=preferred_username before upgrading. See

MIGRATING.md, and Upgrading for other versions.

Understand in five steps

An agent connected through one service account with broad rights reaches Trino under that account, so the rules written for Carol no longer apply. The left panel is an illustration: the sandbox's policy would refuse such an account. akko-mcp-trino brings Carol's own identity to Trino, and the rules Trino already has do the rest.

The same query from the three users of the sandbox, through the same MCP client and the same server. Trino applies the sandbox's OPA policy to each of them; the server copies no rule.

A real trial, tool call by tool call: Mistral on 0.7.0 looks for the segment with the largest balance. The search matches word by word, the error on a wrong join names the table to read, and the agent fixes its join. Every tool answer shown is the server's, replayed in the sandbox.

Four identity modes, from the safest to the simplest. jwt is the default; service gives every caller the same account and is used only when you name it.

The same five business questions, put to Mistral and to Claude, on 0.6.1 and on 0.7.0. Mistral varies more from one run to the next than the gap between the versions, and 0.7.0 sends about 41% more input tokens per question, because its tool descriptions are longer. The harness and its reports are in akko-sandbox.

The interactive version of these five steps is on akko-ai.com/en/docs/understand (also en français).

Try it in five minutes

The sandbox starts Keycloak, Trino, OPA and the server on your machine, with the three users above:

git clone https://github.com/AKKO-p/akko-sandbox.git

cd akko-sandbox docker compose up -d --wait ./demo.sh

The quickstart goes on with a user's token, an MCP host and a first question.

Why

An agent that reads a lakehouse needs a small, predictable surface: a few tools whose descriptions a model understands, answers with hard limits, and a guarantee that a prompt injection cannot turn a question into a DROP TABLE through this server. This server is that surface, and nothing else. It does not decide access: Trino decides for each user with the rules it already has, or, in service mode, for the one identity you give it.

Features

  • Read-only by construction, through this server. SQL is parsed into an AST and refused if a write appears anywhere in the tree, CTEs and subqueries included. Table functions (TABLE(...), such as a JDBC connector's system.query) and the system catalog are refused too, including through a name without a catalog when the session catalog is system. What a user can do in Trino by other means is governed by Trino's rules: see Security.
  • Per-user rights by default. In jwt mode, the default, the server verifies the caller's token (issued for this server, never for Trino), exchanges it at the identity provider for a token whose audience is Trino (RFC 8693), and Trino runs the query as that user. The caller's token is never passed on. A request without a valid token is refused with 401.
  • A fallback without token exchange. In impersonation mode, the server authenticates to Trino with its own account (password or client certificate), and Trino runs the query as the verified caller, under an impersonation rule that only this account has.
  • One identity, only when named. In service mode, every query runs as TRINO_USER. It is never chosen by default, and the server says so at start and to every host in its initialization instructions.
  • Limits by default. A row cap with a truncated flag (100), a time budget per query, cancelled in Trino (60 s), and a time budget per tool call (120 s).
  • One audit line per call. Keyed by X-Request-Id, never holding the token or the SQL text: who called which tool, with which outcome, for how long.
  • Nine tools, annotated with what they can really do: execute_query is annotated read-only only while TRINO_READ_ONLY is true.
  • Token verification. Bearer tokens are verified against any OIDC provider's JWKS (issuer, audience bound to this server, expiry, clock tolerance), a token issued for Trino is refused, the protected resource metadata is published (RFC 9728), and the Host header is filtered.
  • Extensible without forking. Tool plugins and extensions are Python packages named at start: identity modes, guards, audit fields, routes, tools. An extension can only refuse what the core allows, never widen it.
  • Any MCP host, any model. Cursor, Claude Desktop, VS Code and the Python SDK; and any model, Mistral included, through the example agent.
  • Tests. 100% line and branch coverage, including in-process suites on the real SDK for all three transports, a live run against Keycloak and Trino in CI (integration/), and a check that the package imports no vendor-specific code.

Documentation

These pages describe main. The documentation of a release is at its tag.

PageWhat it covers
Prerequisiteswhat you need, and the versions supported and tested
Quickstartthe sandbox, a user's token, a host, a first question
Deploymentinstall and run, the container, Helm on Kubernetes and OpenShift, Trino Gateway, with or without a data catalog
Identitythe four identity modes, the user claim, token verification
Connect an MCP hostClaude Desktop, Cursor, any stdio host, the Python SDK, an agent
Context from a data catalogwhat a context provider serves, its limits, the file provider

| Modules | token-policy, fingerprint-audit

Nur der Anfang wird gezeigt; den Rest findest du im Repo