Skip to main content
Glama
MCP Trino Server

MCP Trino Server

by alaturqua

Servidor MCP Trino

insignia de herrería Python 3.11+ Código VS Estibador Licencia

El servidor MCP Trino es un servidor de protocolo de contexto de modelo (MCP) que proporciona una integración perfecta con Trino e Iceberg, lo que permite capacidades avanzadas de exploración de datos, consultas y mantenimiento de tablas a través de una interfaz estándar.

Casos de uso

  • Exploración y análisis de datos interactivos en Trino

  • Mantenimiento y optimización automatizados de tablas Iceberg

  • Creación de herramientas impulsadas por IA que interactúan con las bases de datos de Trino

  • Ejecución y gestión de consultas SQL con formato de resultado adecuado

Related MCP server: Alibaba Cloud DMS MCP Server

Prerrequisitos

  1. Un servidor Trino en ejecución (o Docker Compose para desarrollo local)

  2. Python 3.11 o superior

  3. Docker (opcional, para implementación en contenedores)

Instalación

Instalación mediante herrería

Para instalar MCP Trino Server para Claude Desktop automáticamente a través de Smithery :

npx -y @smithery/cli install @alaturqua/mcp-trino-python --client claude

Ejecución de Trino localmente

La forma más fácil de comenzar es utilizar la configuración de Docker Compose incluida para ejecutar Trino localmente:

docker-compose up -d

Esto iniciará un servidor Trino en localhost:8080 . Ahora puede continuar con la configuración del servidor MCP.

Uso con VS Code

Para una instalación rápida, puede agregar la siguiente configuración a sus ajustes de VS Code. Para ello, presione Ctrl + Shift + P y escriba Preferences: Open User Settings (JSON) .

Opcionalmente, puede agregarlo a un archivo llamado .vscode/mcp.json en su espacio de trabajo. Esto le permitirá compartir la configuración con otros.

Tenga en cuenta que la clave mcp no es necesaria en el archivo .vscode/mcp.json .

{
  "mcp": {
    "servers": {
      "trino": {
        "command": "docker",
        "args": ["run", "--rm", "ghcr.io/alaturqua/mcp-trino-python:latest"],
        "env": {
          "TRINO_HOST": "${input:trino_host}",
          "TRINO_PORT": "${input:trino_port}",
          "TRINO_USER": "${input:trino_user}",
          "TRINO_PASSWORD": "${input:trino_password}",
          "TRINO_HTTP_SCHEME": "${input:trino_http_scheme}",
          "TRINO_CATALOG": "${input:trino_catalog}",
          "TRINO_SCHEMA": "${input:trino_schema}"
        }
      }
    }
  }
}

Uso con Claude Desktop

Agregue la siguiente configuración a la configuración de Claude Desktop:

{
  "mcpServers": {
    "trino": {
      "command": "python",
      "args": ["./src/server.py"],
      "env": {
        "TRINO_HOST": "your-trino-host",
        "TRINO_PORT": "8080",
        "TRINO_USER": "trino"
      }
    }
  }
}

Configuración

Variables de entorno

Variable

Descripción

Por defecto

TRINO_HOST

Nombre de host del servidor Trino

host local

TRINO_PORT

Puerto del servidor Trino

8080

TRINO_USUARIO

Nombre de usuario de Trino

trino

CATÁLOGO TRINO

Catálogo predeterminado

Ninguno

ESQUEMA TRINO

Esquema predeterminado

Ninguno

ESQUEMA TRINO_HTTP

Esquema HTTP (http/https)

http

TRINO_CONTRASEÑA

Contraseña de Trino

Ninguno

Herramientas

Herramientas de consulta y exploración

  • mostrar_catálogos

    • Listado de todos los catálogos disponibles

    • No se requieren parámetros

  • mostrar_esquemas

    • Enumerar todos los esquemas en un catálogo

    • Parámetros:

      • catalog : Nombre del catálogo (cadena, obligatorio)

  • mostrar_tablas

    • Enumerar todas las tablas de un esquema

    • Parámetros:

      • catalog : Nombre del catálogo (cadena, obligatorio)

      • schema : nombre del esquema (cadena, obligatorio)

  • describe_tabla

    • Mostrar la estructura detallada de la tabla y la información de las columnas

    • Parámetros:

      • table : Nombre de la tabla (cadena, obligatoria)

      • catalog : Nombre del catálogo (cadena, opcional)

      • schema : nombre del esquema (cadena, opcional)

  • ejecutar_consulta

    • Ejecutar una consulta SQL y devolver resultados formateados

    • Parámetros:

      • query : consulta SQL a ejecutar (cadena, obligatoria)

  • mostrar_árbol_del_catálogo

    • Mostrar una vista de árbol jerárquica de catálogos, esquemas y tablas

    • Devuelve una estructura de árbol formateada con indicadores visuales

    • No se requieren parámetros

  • mostrar_crear_tabla

    • Mostrar la declaración CREATE TABLE para una tabla

    • Parámetros:

      • table : Nombre de la tabla (cadena, obligatoria)

      • catalog : Nombre del catálogo (cadena, opcional)

      • schema : nombre del esquema (cadena, opcional)

  • mostrar_crear_vista

    • Mostrar la declaración CREATE VIEW para una vista

    • Parámetros:

      • view : Nombre de la vista (cadena, obligatoria)

      • catalog : Nombre del catálogo (cadena, opcional)

      • schema : nombre del esquema (cadena, opcional)

  • mostrar_estadísticas

    • Mostrar estadísticas de una tabla

    • Parámetros:

      • table : Nombre de la tabla (cadena, obligatoria)

      • catalog : Nombre del catálogo (cadena, opcional)

      • schema : nombre del esquema (cadena, opcional)

Mantenimiento de la tabla Iceberg

  • optimizar

    • Optimice una tabla Iceberg compactando archivos pequeños

    • Parámetros:

      • table : Nombre de la tabla (cadena, obligatoria)

      • catalog : Nombre del catálogo (cadena, opcional)

      • schema : nombre del esquema (cadena, opcional)

  • optimizar_manifiestos

    • Optimizar archivos de manifiesto para una tabla Iceberg

    • Parámetros:

      • table : Nombre de la tabla (cadena, obligatoria)

      • catalog : Nombre del catálogo (cadena, opcional)

      • schema : nombre del esquema (cadena, opcional)

  • instantáneas de caducidad

    • Eliminar instantáneas antiguas de una tabla Iceberg

    • Parámetros:

      • table : Nombre de la tabla (cadena, obligatoria)

      • retention_threshold : Umbral de edad (p. ej., "7d") (cadena, opcional)

      • catalog : Nombre del catálogo (cadena, opcional)

      • schema : nombre del esquema (cadena, opcional)

Inspección de metadatos de Iceberg

  • mostrar_propiedades_de_tabla

    • Mostrar las propiedades de la tabla Iceberg

    • Parámetros:

      • table : Nombre de la tabla (cadena, obligatoria)

      • catalog : Nombre del catálogo (cadena, opcional)

      • schema : nombre del esquema (cadena, opcional)

  • mostrar_historial_de_tablas

    • Mostrar el historial/registro de cambios de la tabla Iceberg

    • Contiene información de instantáneas sobre el tiempo, el linaje y la ascendencia.

    • Parámetros:

      • table : Nombre de la tabla (cadena, obligatoria)

      • catalog : Nombre del catálogo (cadena, opcional)

      • schema : nombre del esquema (cadena, opcional)

  • mostrar_entradas_del_registro_de_metadatos

    • Mostrar las entradas del registro de metadatos de la tabla Iceberg

    • Contiene ubicaciones de archivos de metadatos e información de secuencia.

    • Parámetros:

      • table : Nombre de la tabla (cadena, obligatoria)

      • catalog : Nombre del catálogo (cadena, opcional)

      • schema : nombre del esquema (cadena, opcional)

  • mostrar_instantáneas

    • Mostrar instantáneas de la tabla Iceberg

    • Contiene detalles de instantáneas, incluidas operaciones y archivos de manifiesto.

    • Parámetros:

      • table : Nombre de la tabla (cadena, obligatoria)

      • catalog : Nombre del catálogo (cadena, opcional)

      • schema : nombre del esquema (cadena, opcional)

  • mostrar_manifiestos

    • Mostrar los manifiestos de la tabla Iceberg para las instantáneas actuales o todas

    • Contiene detalles del archivo de manifiesto y estadísticas del archivo de datos.

    • Parámetros:

      • table : Nombre de la tabla (cadena, obligatoria)

      • catalog : Nombre del catálogo (cadena, opcional)

      • schema : nombre del esquema (cadena, opcional)

      • all_snapshots : incluye todas las instantáneas (booleano, opcional)

  • mostrar_particiones

    • Mostrar particiones de la tabla Iceberg

    • Contiene estadísticas de particiones y recuentos de archivos.

    • Parámetros:

      • table : Nombre de la tabla (cadena, obligatoria)

      • catalog : Nombre del catálogo (cadena, opcional)

      • schema : nombre del esquema (cadena, opcional)

  • mostrar_archivos

    • Mostrar los archivos de datos de la tabla Iceberg en la instantánea actual

    • Contiene metadatos de archivos detallados y estadísticas de columnas.

    • Parámetros:

      • table : Nombre de la tabla (cadena, obligatoria)

      • catalog : Nombre del catálogo (cadena, opcional)

      • schema : nombre del esquema (cadena, opcional)

  • mostrar_entradas

    • Mostrar las entradas del manifiesto de la tabla Iceberg para las instantáneas actuales o todas

    • Contiene el estado de la entrada y métricas detalladas del archivo.

    • Parámetros:

      • table : Nombre de la tabla (cadena, obligatoria)

      • catalog : Nombre del catálogo (cadena, opcional)

      • schema : nombre del esquema (cadena, opcional)

      • all_snapshots : incluye todas las instantáneas (booleano, opcional)

  • mostrar_referencias

    • Mostrar referencias de la tabla Iceberg (ramas y etiquetas)

    • Contiene configuración de referencia y mapeo de instantáneas

    • Parámetros:

      • table : Nombre de la tabla (cadena, obligatoria)

      • catalog : Nombre del catálogo (cadena, opcional)

      • schema : nombre del esquema (cadena, opcional)

Historial de consultas

  • mostrar_historial_de_consultas

    • Obtener el historial de consultas ejecutadas

    • Parámetros:

      • limit : Número máximo de consultas a devolver (número, opcional)

Licencia

Este proyecto está licenciado bajo la licencia Apache 2.0. Consulte el archivo de LICENCIA para conocer los términos completos.

Available Tools

22 tools
describe_tableC

Describe a table

Inputs: catalog (required), schema_name (required), table (required). Returns: result

execute_queryC

Execute a SQL query and return results in a readable format

Inputs: query (required). Returns: result

expire_snapshotsB

Remove old snapshots from an Iceberg table

Inputs: catalog (required), schema_name (required), table (required), retention_threshold. Returns: result

optimizeB

Optimize an Iceberg table's data files

Inputs: catalog (required), schema_name (required), table (required). Returns: result

optimize_manifestsC

Optimize manifest files for an Iceberg table

Inputs: catalog (required), schema_name (required), table (required). Returns: result

show_catalogsB

List all available catalogs

Inputs: no named parameters. Returns: result

show_catalog_treeA

Show a hierarchical tree view of catalogs, schemas, and tables

Inputs: no named parameters. Returns: result

show_create_tableA

Show the CREATE TABLE statement for a specific table

Inputs: catalog (required), schema_name (required), table (required). Returns: result

show_create_viewB

Show the CREATE VIEW statement for a specific view

Inputs: catalog (required), schema_name (required), view (required). Returns: result

show_entriesC

Show Iceberg table manifest entries

Inputs: catalog (required), schema_name (required), table (required), all_snapshots. Returns: result

show_filesC

Show Iceberg table data files

Inputs: catalog (required), schema_name (required), table (required). Returns: result

show_manifestsC

Show Iceberg table manifests

Inputs: catalog (required), schema_name (required), table (required), all_snapshots. Returns: result

show_metadata_log_entriesC

Show metadata for the table

Inputs: catalog (required), schema_name (required), table (required). Returns: result

show_partitionsB

Show Iceberg table partitions

Inputs: catalog (required), schema_name (required), table (required). Returns: result

show_query_historyB

Get the history of executed queries

Inputs: limit. Returns: result

show_refsA

Show Iceberg table references (branches and tags)

Inputs: catalog (required), schema_name (required), table (required). Returns: result

show_schemasB

List all schemas in a catalog

Inputs: catalog (required). Returns: result

show_snapshotsC

Show Iceberg table snapshots

Inputs: catalog (required), schema_name (required), table (required). Returns: result

show_statsC

Show statistics for a table

Inputs: catalog (required), schema_name (required), table (required). Returns: result

show_table_historyC

Show Iceberg table history/changelog

Inputs: catalog (required), schema_name (required), table (required). Returns: result

show_table_propertiesC

Show Iceberg table properties

Inputs: catalog (required), schema_name (required), table (required). Returns: result

show_tablesB

List all tables in a schema

Inputs: catalog (required), schema_name (required). Returns: result

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.1/5.0

    Scored across 22 tools

    Disambiguation4/5

    Most tools have distinct purposes, especially the 'show_' variants which target different Iceberg metadata. However, some concepts like show_table_history, show_metadata_log_entries, and show_snapshots overlap conceptually, causing minor potential confusion.

    Naming Consistency4/5

    All tools follow a verb_noun pattern with underscores, which is consistent. The verbs vary (show, describe, execute, expire, optimize) but are clear and appropriate, though a fully uniform verb set would improve consistency.

    Tool Count4/5

    22 tools is on the higher side but remains reasonable given the dual focus on general Trino queries and detailed Iceberg management. The scope justifies the count, though it could be split into two servers for clarity.

    Completeness4/5

    The tool set covers core query operations and comprehensive Iceberg maintenance (snapshots, files, optimization, history). Missing DDL commands like create/drop table or schema are notable gaps but align with the server's apparent administrative/analytical focus.

    Maintenance

    ActivityNo data
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      B
      quality
      D
      maintenance
      A Model Context Protocol server that provides a SQL interface for querying and managing Apache Iceberg tables through Claude desktop, allowing natural language interaction with Iceberg data lakes.
      1
      8
      -
    • A
      license
      Not graded
      quality
      D
      maintenance
      MCP server providing seamless integration with Trino and Iceberg for advanced data exploration, querying, and table maintenance.
      Apache 2.0
    • A
      license
      B
      quality
      D
      maintenance
      Model Context Protocol server for read-only access to Iceberg tables through Cloudera Trino: schema discovery, SQL queries, metadata-based health checks, time travel, and performance analysis.
      17
      3
      Apache 2.0