SuperAPI AI 工具集

mz-health-check

智能体与模型

查看项目

更新于 10-16 00:06

技能介绍

用途:通过 MCP Developer 端点分析 Materialize 环境,产出结构化健康报告,涵盖新鲜度、水合状态、内存与资源占用、Worker 倾斜、索引建议与成本分析,并给出带具体 SQL 的优化建议;同时可指导把 Claude Code、Cursor、VS Code、Zed、Continue、Windsurf、Claude Desktop 等 MCP 客户端连接到 materialize-developer 服务器。

主要能力:开发者端点提供两个只读工具。query_system_catalog 仅允许对系统目录表(mz_*、pg_catalog、information_schema)执行 SELECT/SHOW/EXPLAIN,不接受 cluster 参数;query(v26.30 起)可对角色可访问的任意对象执行,需指定 cluster,v26.33 起可选 cluster_replica,EXPLAIN ANALYZE 与读取用户数据必须用它。分析流程为:连接验证、发现对象清单、分析性能指标、生成报告。

使用方式:先确认工具可用,例如 query_system_catalog: SELECT mz_version() FROM mz_catalog.mz_databases LIMIT 1。不要猜测列名,用 mz_internal 的 ontology 视图(mz_ontology_entity_types、mz_ontology_link_types、mz_ontology_properties、mz_ontology_semantic_types)发现表、列与连接路径,并用 SHOW COLUMNS 校验。每次调用只执行一条只读语句,不加 SET,末尾分号最多一个。结果是无列名的行数组,别名被丢弃,需按位置映射;数字以字符串返回,时间戳为毫秒纪元字符串。

适用场景:Materialize 集群健康巡检、物化视图滞后与陈旧排查、水合失败、OOM 重启、Worker 倾斜、索引与成本优化。

限制:mz_introspection 关系是集群作用域的,必须通过 query 指定 cluster(多副本时还需 cluster_replica),否则可能返回空结果或报错。响应默认上限 1 MB、请求默认超时 60 秒。所有修复均为 DDL,两个工具都会拒绝,需交由用户执行,且未经用户同意不得应用。未提供具体收费与价格信息。