# AKKO MCP server for Trino

MCP-сервер AKKO MCP server for Trino для Claude Code даёт агенту доступ только для чтения к Trino. Запросы выполняются с правами текущего пользователя.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 7 у репозитория
- Автор: AKKO-p
- Лицензия: Apache-2.0 · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/AKKO-p/akko-mcp-trino
- Обновлён: 2026-11-14
- Проверка безопасности: автоматическая, 2026-11-17 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/mcp/akko-mcp-server-for-trino

## Что делает

AKKO MCP server for Trino позволяет агенту находить таблицы и столбцы, описывать схемы и таблицы, просматривать каталоги и запускать разрешённые запросы. Сервер разбирает каждый оператор и отклоняет запись до обращения к Trino.

Пользовательский токен проверяется сервером, затем через OAuth 2.0 Token Exchange запрашивается отдельный токен для Trino. Исходный токен пользователя сервер не передаёт дальше. Политики Trino, включая OPA или Ranger, сами определяют доступ к данным.

Результаты ограничиваются по числу строк и времени, а каждый вызов оставляет строку аудита. Для запуска нужны Trino, `uvx`, провайдер идентификации и параметры `TRINO_HOST`, `TRINO_HTTP_SCHEME`, `MCP_JWKS_URL`, `MCP_OIDC_ISSUER` и `MCP_OIDC_AUDIENCE`; для режима обмена токенами также задаются `TRINO_TOKEN_EXCHANGE_CLIENT_SECRET` и `MCP_USER_TOKEN`.

## Требования
- Нужно: Python и uv (команды через uvx)
- Переменные окружения: `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` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

### Claude Code (родная платформа)

**Командой платформы**
```bash
claude mcp add akko-mcp-trino -e TRINO_HOST=<TRINO_HOST> -e TRINO_HTTP_SCHEME=<TRINO_HTTP_SCHEME> -e MCP_JWKS_URL=<MCP_JWKS_URL> -e MCP_OIDC_ISSUER=<MCP_OIDC_ISSUER> -e MCP_OIDC_AUDIENCE=<MCP_OIDC_AUDIENCE> -e TRINO_TOKEN_EXCHANGE_CLIENT_SECRET=<TRINO_TOKEN_EXCHANGE_CLIENT_SECRET> -e MCP_USER_TOKEN=<MCP_USER_TOKEN> -- uvx akko-mcp-trino
```
Вместо <…> подставьте свои значения. Ещё 6 переменных окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from akko-mcp-trino <команда>

### Codex

**Командой платформы**
```bash
codex mcp add akko-mcp-server-for-trino --env TRINO_HOST=<TRINO_HOST> --env TRINO_HTTP_SCHEME=<TRINO_HTTP_SCHEME> --env MCP_JWKS_URL=<MCP_JWKS_URL> --env MCP_OIDC_ISSUER=<MCP_OIDC_ISSUER> --env MCP_OIDC_AUDIENCE=<MCP_OIDC_AUDIENCE> -- uvx akko-mcp-trino
```
Вместо <…> подставьте свои значения. Ещё 6 переменных окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from akko-mcp-trino <команда>

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "akko-mcp-server-for-trino": {
            "command": "uvx",
            "args": [
                "akko-mcp-trino"
            ],
            "env": {
                "TRINO_HOST": "<TRINO_HOST>",
                "TRINO_HTTP_SCHEME": "<TRINO_HTTP_SCHEME>",
                "MCP_JWKS_URL": "<MCP_JWKS_URL>",
                "MCP_OIDC_ISSUER": "<MCP_OIDC_ISSUER>",
                "MCP_OIDC_AUDIENCE": "<MCP_OIDC_AUDIENCE>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения. Ещё 6 переменных окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from akko-mcp-trino <команда>

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "akko-mcp-server-for-trino": {
            "type": "stdio",
            "command": "uvx",
            "args": [
                "akko-mcp-trino"
            ],
            "env": {
                "TRINO_HOST": "<TRINO_HOST>",
                "TRINO_HTTP_SCHEME": "<TRINO_HTTP_SCHEME>",
                "MCP_JWKS_URL": "<MCP_JWKS_URL>",
                "MCP_OIDC_ISSUER": "<MCP_OIDC_ISSUER>",
                "MCP_OIDC_AUDIENCE": "<MCP_OIDC_AUDIENCE>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения. Ещё 6 переменных окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from akko-mcp-trino <команда>

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add -e TRINO_HOST=<TRINO_HOST> -e TRINO_HTTP_SCHEME=<TRINO_HTTP_SCHEME> -e MCP_JWKS_URL=<MCP_JWKS_URL> -e MCP_OIDC_ISSUER=<MCP_OIDC_ISSUER> -e MCP_OIDC_AUDIENCE=<MCP_OIDC_AUDIENCE> akko-mcp-server-for-trino uvx akko-mcp-trino
```
Вместо <…> подставьте свои значения. Ещё 6 переменных окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from akko-mcp-trino <команда>

## Когда брать
- найти таблицы и столбцы в Trino
- описать схему или таблицу перед запросом
- выполнить запрос без операций записи
- сохранить права и политики конкретного пользователя
- ограничить объём и время ответа агента

## Примеры запросов агенту
- Найди таблицы и столбцы, связанные с заказами, в Trino.
- Опиши схему `analytics` и таблицу `customers`.
- Выполни запрос к данным с моими правами и верни результат.

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
