Skip to main content
Glama
MCP Trino Server

MCP Trino Server

by alaturqua

MCP 트리노 서버

대장간 배지 파이썬 3.11+ VS 코드 도커 특허

MCP Trino 서버는 Trino와 Iceberg와의 원활한 통합을 제공하는 MCP(Model Context Protocol) 서버로, 표준 인터페이스를 통해 고급 데이터 탐색, 쿼리 및 테이블 유지 관리 기능을 제공합니다.

사용 사례

  • Trino에서의 대화형 데이터 탐색 및 분석

  • 자동화된 Iceberg 테이블 유지 관리 및 최적화

  • Trino 데이터베이스와 상호 작용하는 AI 기반 도구 구축

  • 적절한 결과 형식을 사용하여 SQL 쿼리 실행 및 관리

Related MCP server: Alibaba Cloud DMS MCP Server

필수 조건

  1. 실행 중인 Trino 서버(또는 로컬 개발을 위한 Docker Compose)

  2. Python 3.11 이상

  3. Docker(컨테이너화된 배포를 위한 선택 사항)

설치

Smithery를 통해 설치

Smithery를 통해 Claude Desktop에 MCP Trino Server를 자동으로 설치하는 방법:

지엑스피1

Trino를 로컬로 실행

시작하는 가장 쉬운 방법은 포함된 Docker Compose 구성을 사용하여 Trino를 로컬로 실행하는 것입니다.

docker-compose up -d

그러면 localhost:8080 에서 Trino 서버가 시작됩니다. 이제 MCP 서버 구성을 진행할 수 있습니다.

VS Code를 사용한 사용

빠른 설치를 위해 VS Code 설정에 다음 구성을 추가할 수 있습니다. Ctrl + Shift + P 를 누르고 Preferences: Open User Settings (JSON) 입력하면 됩니다.

원하는 경우, 작업 공간의 .vscode/mcp.json 파일에 추가할 수 있습니다. 이렇게 하면 다른 사용자와 구성을 공유할 수 있습니다.

.vscode/mcp.json 파일에는 mcp 키가 필요하지 않습니다.

{
  "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}"
        }
      }
    }
  }
}

Claude Desktop과 함께 사용

Claude Desktop 설정에 다음 구성을 추가하세요.

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

구성

환경 변수

변하기 쉬운

설명

기본

트리노 호스트

Trino 서버 호스트 이름

로컬호스트

트리노_포트

트리노 서버 포트

8080

트리노_유저

트리노 사용자 이름

트리노

트리노_카탈로그

기본 카탈로그

없음

트리노_스키마

기본 스키마

없음

트리노_HTTP_스킴

HTTP 스키마(http/https)

http

트리노 비밀번호

트리노 비밀번호

없음

도구

쿼리 및 탐색 도구

  • 쇼_카탈로그

    • 사용 가능한 모든 카탈로그를 나열하세요

    • 매개변수가 필요하지 않습니다

  • show_schemas

    • 카탈로그의 모든 스키마 나열

    • 매개변수:

      • catalog : 카탈로그 이름(문자열, 필수)

  • 쇼_테이블

    • 스키마의 모든 테이블 나열

    • 매개변수:

      • catalog : 카탈로그 이름(문자열, 필수)

      • schema : 스키마 이름(문자열, 필수)

  • 설명_테이블

    • 자세한 테이블 구조 및 열 정보 표시

    • 매개변수:

      • table : 테이블 이름(문자열, 필수)

      • catalog : 카탈로그 이름(문자열, 선택 사항)

      • schema : 스키마 이름(문자열, 선택 사항)

  • 실행_쿼리

    • SQL 쿼리를 실행하고 포맷된 결과를 반환합니다.

    • 매개변수:

      • query : 실행할 SQL 쿼리(문자열, 필수)

  • 쇼_카탈로그_트리

    • 카탈로그, 스키마 및 테이블의 계층적 트리 보기 표시

    • 시각적 표시기가 포함된 포맷된 트리 구조를 반환합니다.

    • 매개변수가 필요하지 않습니다

  • show_create_table

    • 테이블에 대한 CREATE TABLE 문을 표시합니다.

    • 매개변수:

      • table : 테이블 이름(문자열, 필수)

      • catalog : 카탈로그 이름(문자열, 선택 사항)

      • schema : 스키마 이름(문자열, 선택 사항)

  • 쇼_크리에이트_뷰

    • 뷰에 대한 CREATE VIEW 문을 표시합니다.

    • 매개변수:

      • view : 뷰 이름(문자열, 필수)

      • catalog : 카탈로그 이름(문자열, 선택 사항)

      • schema : 스키마 이름(문자열, 선택 사항)

  • 쇼_통계

    • 표에 대한 통계 표시

    • 매개변수:

      • table : 테이블 이름(문자열, 필수)

      • catalog : 카탈로그 이름(문자열, 선택 사항)

      • schema : 스키마 이름(문자열, 선택 사항)

빙산 테이블 유지 관리

  • 최적화하다

    • 작은 파일을 압축하여 Iceberg 테이블 최적화

    • 매개변수:

      • table : 테이블 이름(문자열, 필수)

      • catalog : 카탈로그 이름(문자열, 선택 사항)

      • schema : 스키마 이름(문자열, 선택 사항)

  • 최적화 매니페스트

    • Iceberg 테이블에 대한 매니페스트 파일 최적화

    • 매개변수:

      • table : 테이블 이름(문자열, 필수)

      • catalog : 카탈로그 이름(문자열, 선택 사항)

      • schema : 스키마 이름(문자열, 선택 사항)

  • 만료_스냅샷

    • Iceberg 테이블에서 이전 스냅샷 제거

    • 매개변수:

      • table : 테이블 이름(문자열, 필수)

      • retention_threshold : 연령 임계값(예: "7d")(문자열, 선택 사항)

      • catalog : 카탈로그 이름(문자열, 선택 사항)

      • schema : 스키마 이름(문자열, 선택 사항)

빙산 메타데이터 검사

  • 테이블 속성 표시

    • Iceberg 테이블 속성 표시

    • 매개변수:

      • table : 테이블 이름(문자열, 필수)

      • catalog : 카탈로그 이름(문자열, 선택 사항)

      • schema : 스키마 이름(문자열, 선택 사항)

  • 쇼_테이블_히스토리

    • Iceberg 테이블 기록/변경 로그 표시

    • 스냅샷 타이밍, 혈통 및 조상 정보가 포함되어 있습니다.

    • 매개변수:

      • table : 테이블 이름(문자열, 필수)

      • catalog : 카탈로그 이름(문자열, 선택 사항)

      • schema : 스키마 이름(문자열, 선택 사항)

  • 메타데이터 로그 항목 표시

    • Iceberg 테이블 메타데이터 로그 항목 표시

    • 메타데이터 파일 위치 및 시퀀스 정보가 포함되어 있습니다.

    • 매개변수:

      • table : 테이블 이름(문자열, 필수)

      • catalog : 카탈로그 이름(문자열, 선택 사항)

      • schema : 스키마 이름(문자열, 선택 사항)

  • 쇼_스냅샷

    • Iceberg 테이블 스냅샷 표시

    • 작업 및 매니페스트 파일을 포함한 스냅샷 세부 정보가 포함되어 있습니다.

    • 매개변수:

      • table : 테이블 이름(문자열, 필수)

      • catalog : 카탈로그 이름(문자열, 선택 사항)

      • schema : 스키마 이름(문자열, 선택 사항)

  • 쇼_매니페스트

    • 현재 또는 모든 스냅샷에 대한 Iceberg 테이블 매니페스트 표시

    • 매니페스트 파일 세부 정보 및 데이터 파일 통계가 포함되어 있습니다.

    • 매개변수:

      • table : 테이블 이름(문자열, 필수)

      • catalog : 카탈로그 이름(문자열, 선택 사항)

      • schema : 스키마 이름(문자열, 선택 사항)

      • all_snapshots : 모든 스냅샷 포함(부울, 선택 사항)

  • show_partitions

    • Iceberg 테이블 파티션 표시

    • 파티션 통계 및 파일 개수를 포함합니다.

    • 매개변수:

      • table : 테이블 이름(문자열, 필수)

      • catalog : 카탈로그 이름(문자열, 선택 사항)

      • schema : 스키마 이름(문자열, 선택 사항)

  • 파일 표시

    • 현재 스냅샷에 Iceberg 테이블 데이터 파일 표시

    • 자세한 파일 메타데이터와 열 통계를 포함합니다.

    • 매개변수:

      • table : 테이블 이름(문자열, 필수)

      • catalog : 카탈로그 이름(문자열, 선택 사항)

      • schema : 스키마 이름(문자열, 선택 사항)

  • show_entries

    • 현재 또는 모든 스냅샷에 대한 Iceberg 테이블 매니페스트 항목 표시

    • 항목 상태 및 자세한 파일 메트릭이 포함되어 있습니다.

    • 매개변수:

      • table : 테이블 이름(문자열, 필수)

      • catalog : 카탈로그 이름(문자열, 선택 사항)

      • schema : 스키마 이름(문자열, 선택 사항)

      • all_snapshots : 모든 스냅샷 포함(부울, 선택 사항)

  • 참조 표시

    • Iceberg 테이블 참조(분기 및 태그) 표시

    • 참조 구성 및 스냅샷 매핑이 포함되어 있습니다.

    • 매개변수:

      • table : 테이블 이름(문자열, 필수)

      • catalog : 카탈로그 이름(문자열, 선택 사항)

      • schema : 스키마 이름(문자열, 선택 사항)

쿼리 기록

  • 쿼리 기록 표시

    • 실행된 쿼리의 기록을 가져옵니다

    • 매개변수:

      • limit : 반환할 최대 쿼리 수(숫자, 선택 사항)

특허

이 프로젝트는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 전체 내용은 라이선스 파일을 참조하세요.

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