MCP 工具清单¶

本文档介绍 Owl MCP Server 当前可通过 MCP 包装工具调用的业务工具能力，包括工具分类、权限类型、使用约定、工具总览，以及典型 MCP 使用路径。

工具可见范围和调用结果取决于当前接入使用的 API Key 权限。若 API Key 没有相关资源或操作权限，对应工具调用可能会失败，或返回空结果。

工具范围¶

Owl MCP Server 可执行的业务工具会随平台能力持续更新。实际可执行工具以 list_catalogs 和 list_tools 返回的工具目录为准。

当前文档覆盖以下业务分类：

权限类型¶

使用约定¶

MCP 客户端应按以下顺序调用：

1. 调用 list_catalogs 查看可用分类。
2. 调用 list_tools，传入 catalog_id，查看该分类下的业务工具和参数。
3. 调用 exec_tool，传入 tool_name 和 parameters 执行业务工具。

工具总览¶

Account¶

用于发现与当前 API Key 工作空间同组织的其他工作空间。得到的 workspace_uuid 可作为 owl.data.simple_query 的 same_org_workspace_uuids 入参，用于跨工作空间查询。

注意：返回结果中的 workspace_uuid 才是后续 same_org_workspace_uuids 入参，不要传 workspace_id。

Catalog¶

用于统一资源目录的实体类型发现、实体查询、实体详情获取和拓扑关系查询。

注意：仪表板工具（owl.dashboard.create / owl.dashboard.replace / owl.dashboard.get）仅在 Owl CLI 中提供，不会出现在 MCP 工具列表中，相关用法请参见 Owl CLI 文档。

Data¶

用于 DQL namespace 探查、数据源和字段发现、日志索引发现、SLO 查询、日志聚类分析，以及面向 MCP 客户端的简化数据查询。当前 MCP 侧提供的是简化查询和查询辅助工具，不包含完整 DQL 或 PromQL 自定义执行工具。

Errors¶

用于错误中心的问题列表查询，以及评论的新增、查询和更新。

Event¶

用于事件中心列表查询和事件详情获取。

Incident¶

用于故障列表、故障评论、操作记录和值班排班查询。

Infrastructure¶

用于基础设施对象列表和详情查询，覆盖主机、容器、进程等资源对象。

LLM¶

用于 LLM 可观测应用列表查询。

Member¶

用于空间成员列表查询和按姓名、邮箱关键字检索。

Monitor¶

用于监控器列表查询、详情获取、创建或更新，以及外部事件接收。

Pipeline¶

用于 Pipeline 列表查询和样例验证。

mdsearch¶

用于检索统一文档语料、按 id 或 path 读取完整文档，以及浏览语料目录结构，支持中文、英文及混合查询。

MCP 使用路径¶

数据查询类问题¶

适用于“查询指标、日志、RUM、APM、Network、Profile 数据”等问题。

1. 通过 exec_tool 调用 owl.data.show_dql_namespace 确认数据 namespace。
2. 根据数据域通过 exec_tool 调用发现类工具：
3. 指标：owl.metric.list
4. RUM：owl.rum.list
5. APM：owl.apm.list
6. Network：owl.network.list
7. Profile：owl.profile.list
8. 日志：owl.logging.list
9. 云账单：owl.billing.list
10. 日志索引：owl.log_index.list
11. 字段目录：owl.field_schema.get
12. 获取必要的 source、field、index 后，通过 exec_tool 调用 owl.data.simple_query 执行查询。

故障排查类问题¶

适用于“查询故障、追踪故障处理过程、补充故障评论”等问题。

1. 通过 exec_tool 调用 owl.incident.list 查询故障单。
2. 根据故障单 incident_uuid 通过 exec_tool 调用：
3. owl.incident_comment.list 查看评论
4. owl.incident_operation.list 查看操作记录
5. 需要补充处理信息时，通过 exec_tool 调用 owl.incident_comment.add。

资源对象定位类问题¶

适用于“查询主机、容器、进程等基础设施对象详情”的问题。

1. 通过 exec_tool 调用 owl.infrastructure.list 查找目标对象。
2. 根据返回结果中的标识信息，通过 exec_tool 调用 owl.infrastructure.get 获取对象详情。

跨工作空间查询类问题¶

适用于“一次查询跨同组织多个工作空间数据”的问题。

1. 通过 exec_tool 调用 owl.account.workspace.same_org.list 发现同组织的候选工作空间。
2. 从返回结果中取 workspace_uuid（不要取 workspace_id）。
3. 把这些 workspace_uuid 作为 same_org_workspace_uuids，通过 exec_tool 传入 owl.data.simple_query 执行跨工作空间查询，最多 20 个工作空间。

监控器管理类问题¶

适用于“查询监控器、创建或更新监控器、发送外部事件”等问题。

1. 通过 exec_tool 调用 owl.monitor.list 查询监控器。
2. 根据返回结果中的 rule_uuid，通过 exec_tool 调用 owl.monitor.get 查看监控器详情。
3. 如需创建或更新监控器，通过 exec_tool 调用 owl.monitor.upsert。
4. 如需发送外部事件，通过 exec_tool 调用 owl.monitor.receive。