MCP 工具清单¶

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

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

工具范围¶

Owl MCP Server 暴露的工具会随平台能力持续更新。实际可见工具以 MCP 客户端连接后返回的工具列表为准。

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

权限类型¶

使用约定¶

工具总览¶

Catalog¶

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

Dashboard¶

用于仪表板的创建、替换和详情获取。

Data¶

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

Errors¶

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

Event¶

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

Incident¶

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

Infrastructure¶

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

LLM¶

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

Member¶

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

Monitor¶

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

Pipeline¶

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

MCP 使用路径¶

数据查询类问题¶

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

1. 调用 owl.data.show_dql_namespace 确认数据 namespace。
2. 根据数据域调用发现类工具：
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.log_index.list
9. 字段目录：owl.field_schema.get
10. 获取必要的 source、field、index 后，调用 owl.data.simple_query 执行查询。

故障排查类问题¶

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

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

资源对象定位类问题¶

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

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

仪表板管理类问题¶

适用于“查询仪表板配置、创建仪表板、替换仪表板内容”等问题。

1. 如需查看已有仪表板，调用 owl.dashboard.get。
2. 如需创建仪表板，调用 owl.dashboard.create。
3. 如需替换已有仪表板内容，调用 owl.dashboard.replace。

监控器管理类问题¶

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

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