SuperAPI AI 工具集

looker

智能体与模型

查看项目

更新于 10-15 23:48

技能介绍

用途:对 EasyPost 的 Looker BI 实例进行语义搜索,帮助定位数据资产。搜索基于本地 qmd 索引,无需凭据;目录抓取与认证类工具需要 Looker API 凭据(环境变量)。

主要能力:默认工具 mcp__looker__search_all(query, limit?, catalog_dir?) 一次搜索查询、Explore 和仪表盘,返回 queries[]、explores[]、dashboards[],按余弦相似度排序;分数 ≥0.65 为强匹配,0.50–0.65 为相关但较弱,<0.50 多为噪声。也可单独使用 search_queries(返回生成的 BigQuery SQL)、search_explores(按 Explore 聚合)、search_dashboards、search_looks。所有搜索工具接受 query(必填)、limit(默认 5,最大 20)、catalog_dir(默认 ~/.looker/catalog)。mcp__looker__get_look(id) 按数字 ID 获取已保存的 Look,需要凭据。

管理工具(需凭据):索引缺失或实例变更后按顺序运行 verify_auth(确认 API 连通)、catalog(增量抓取,写入 ~/.looker/catalog/)、enrich(补充 BQ 表血缘、领域分类和按 Explore 的 markdown,可用 no_annotate: true 跳过 Claude 标注)、index_build(运行 qmd update 刷新索引,无需凭据)。

使用方式:按问题选择工具,例如查仪表盘用 search_all,查 SQL 用 search_queries,查 Explore 用 search_explores。若报“No Looker index found”,依次运行 verify_auth → catalog → enrich → index_build → qmd embed;若报“No Looker results”,说明目录存在但缺少嵌入,检查 index_build 日志中“N unique hashes need vectors”,非零则先运行 qmd embed。搜索无结果或低分时应改写查询,不要默认索引过期。

限制:搜索依赖本地索引,需先抓取并构建;目录与认证工具需要 Looker API 凭据;enrich 的 Claude 标注依赖 Vertex AI;具体凭据配置、平台支持与收费信息暂未提供。