SuperAPI AI 工具集

mcp-developer-analysis

数据与分析

查看项目

更新于 10-16 00:06

技能介绍

用途:通过 MCP Developer 端点分析 Materialize 环境,生成含健康状态、性能发现与优化建议的结构化报告,并指导配置 MCP 客户端(Claude Code、Cursor、VS Code、Zed、Continue、Windsurf、Claude Desktop)连接 materialize-developer 服务器。假定 Materialize v26.24 或更高版本。

主要能力:开发者端点提供两个只读工具。query_system_catalog 仅限对系统目录表(mz_*、pg_catalog、information_schema)执行 SELECT/SHOW/EXPLAIN,不接受 cluster 参数;query(v26.30 起)可对角色可访问的任意对象执行,需指定 cluster,v26.33 起可选 cluster_replica,EXPLAIN ANALYZE 必须用它。工作流为连接、发现、分析、报告四步:用本体视图(mz_ontology_entity_types、mz_ontology_link_types、mz_ontology_properties、mz_ontology_semantic_types)发现表与列,盘点源、物化视图、视图、sink、索引、连接,分析新鲜度(mz_materialization_lag、mz_frontiers)、水合状态、内存与利用率、worker 倾斜、索引建议(mz_index_advice)与成本。

使用方式:每次调用只执行一条只读语句,无 SET,无尾部分号;结果是无列名的行数组,别名被丢弃,需按位置映射列;数字以字符串返回,时间戳为毫秒纪元字符串。对象名不在会话数据库时需加数据库限定。响应默认上限 1 MB、超时 60 秒。mz_introspection 关系必须通过 query 工具并指定 cluster(多副本时还需 cluster_replica)。

限制:两个工具都拒绝 DDL,修复命令需交给用户执行;未提供具体收费与价格信息;部分行为依赖操作员配置(如 enable_mcp_developer_query_tool、enable_mcp_developer 标志)。