Back to MCP directory
publicPublicdnsLocal runtime

mcp-server-trino

一个基于Trino的MCP服务器,提供表查询和SQL执行功能

article

README

🚀 Trino MCP 服务器

本仓库提供了一个 MCP(模型控制协议)服务器,借助它,你可以通过 Python 使用 Trino 来列出和查询表,为数据操作带来便利。

🚀 快速开始

本项目的 MCP 服务器能让你借助 Python 利用 Trino 进行表的列出与查询操作。你可以按照以下步骤开启使用之旅。

✨ 主要特性

  • MCP 功能:MCP 是用于桥接 AI 模型、数据和工具的协议。此示例 MCP 服务器具备以下能力:
    • 可将 Trino 表作为 MCP 资源进行列出。
    • 能够通过 MCP 读取表内容。
    • 提供执行任意 SQL 查询以访问 Trino 数据的工具。
  • Trino 运用:Trino 是用于大数据分析的快速分布式 SQL 查询引擎。本服务器利用 Trino 的 Python 客户端(trino.dbapi)连接到 Trino 主机、目录和模式。

📦 安装指南

要求

  • Python 3.9+(或与 mcp、trino 和 asyncio 兼容的版本)
  • trino(Trino 的 Python 驱动)
  • mcp(Python 模型控制协议库)

📚 详细文档

配置

服务器会从环境变量中读取 Trino 连接详细信息,具体如下:

| 变量 | 描述 | 默认值 | |--------------|---------------------------------------------------------------|------------| | TRINO_HOST | Trino 服务器主机名或 IP | localhost| | TRINO_PORT | Trino 服务器端口 | 8080 | | TRINO_USER | Trino 用户名 | 必填 | | TRINO_PASSWORD | Trino 密码(取决于您的身份验证设置,可选) | 空值 | | TRINO_CATALOG | 默认目录(例如 hivetpchpostgresql 等) | 必填 | | TRINO_SCHEMA | 默认模式(例如 defaultpublic 等) | 必填 |

使用方法

{
  "mcpServers": {
    "trino": {
      "command": "uv",
      "args": [
        "--directory", 
        "<path_to_mcp_server_trino>",
        "run",
        "mcp_server_trino"
      ],
      "env": {
        "TRINO_HOST": "<host>",
        "TRINO_PORT": "<port>",
        "TRINO_USER": "<user>",
        "TRINO_PASSWORD": "<password>",
        "TRINO_CATALOG": "<catalog>",
        "TRINO_SCHEMA": "<schema>"
      }
    }
  }
}

此 JSON 配置示例展示了如何在 MCP 服务器中配置 Trino 服务,涵盖命令行参数和环境变量的设置。你需要将每个字段替换为实际值,以确保能正确连接到目标 Trino 服务器。

help

Runtime guide

cloud

Hosted runtime

Hosted servers run from a provider-managed environment. You usually connect the MCP client to the hosted endpoint or follow the provider's authorization flow, without keeping a local process alive

  1. Open provider connection page
  2. Authorize or copy endpoint
  3. Connect from your MCP client
terminal

Local runtime / other methods

Local servers run on your own machine or infrastructure. You normally copy the server_config into your MCP client, install the required package, and provide env variables from env_schema when needed

  1. Copy server_config
  2. Install required package
  3. Fill env variables and restart client