SuperAPI AI 工具集

mcp-trino

数据与分析

查看项目

更新于 10-16 08:11

技能介绍

用途:mcp-trino 提供 Trino 检查能力,用于查看目录、模式、表与视图、表结构、SQL 查询计划、EXPLAIN ANALYZE 运行信息,以及最近保留的查询历史与单个查询 ID 的记录。应优先依据工具返回的元数据、计划文本和 query-info 负载,而不是凭假设推断。

主要能力与工具选择:list_catalogs 列出可见目录,list_schemas 列出目录中的模式,list_tables 列出模式中的表与视图,get_table_schema 查看列与类型。execute_query 用于 SHOW、SHOW CREATE、DESCRIBE、DESC 等检查语句。explain_query 分析 SQL:静态计划默认用普通 EXPLAIN,可通过 type 选择 LOGICAL、DISTRIBUTED、VALIDATE、IO;通过 format 选择 TEXT、GRAPHVIZ、JSON;需要 JSON 计划时配合 structured: true(对应 FORMAT JSON);只有允许实际执行且需要运行时证据时才用 analyze: true;需要运行 query-info 字段时同时使用 structured: true 与 analyze: true。若计划响应分页,用 offset: nextOffset 和有界 limit 继续,不要请求无界完整计划。查询诊断方面,list_query_history 查看最近保留的已完成、失败或取消查询(属于协调器保留视图,不是审计日志);get_query_by_id 获取记录的 SQL 文本;get_query_detail 获取查询状态、运行时统计、阶段、警告、失败详情或会话字段。大型 query-info 负载应分页读取或先搜索所需字段。

限制与注意:execute_query 仅限检查用途,不接受普通 SELECT、DML、DDL 或多语句 SQL。结论须说明来自静态 EXPLAIN、运行时 EXPLAIN ANALYZE 还是已保存 query-info。有原始 query-info 记录时应优先使用;若缺失或不再保留,需先说明再回退到新的 EXPLAIN ANALYZE。EXPLAIN ANALYZE 会实际执行查询。query-info 工具以配置的 Trino 连接身份读取 /v1/query/{queryId},需要 Trino 认证与可见性规则允许;不要假定 MCP 调用方令牌会转发给 Trino,按调用方隔离需 Trino 模拟与匹配的访问策略。回答应基于工具返回的表元数据、计划文本或 query-info 字段,并明确指出缺失记录、授权失败或仅静态推理的情况,且不要把 SQL 改写与实际执行证据混为一谈。