听云 Network MCP 工具
一、文档概述
| 分类 | 数量 | 操作构成 | 端点 / URI |
|---|---|---|---|
| 资源 | 2 | 2 个只读字典 | tingyun://synthetic/dictionaries/* |
| 告警 | 3 | 3 个只读工具 | /mcp/synthetic/alert |
| 即时监测 | 11 | 5 个只读，6 个写操作 | /mcp/synthetic/instant |
| 任务管理 | 14 | 7 个只读，7 个写操作 | /mcp/synthetic/task |
| 反馈工具 | 1 | 1 个写操作 | 通用，每个端点均提供 |
二、权限类型
| 权限类型 | 含义 | 使用建议 |
|---|---|---|
| 只读 | 查询、检索、列出、获取详情、验证结果、查看使用量或剩余额度等；不创建、更新、启停或删除任务，也不主动发起会消耗拨测额度或流量的监测。 | 可按需开放给 Agent 自动调用；仍需遵循当前账户对任务、节点 、告警和结果数据的可见范围。 |
| 写操作 | 创建即时监测或周期任务、更新任务状态等；会改变工作空间中的任务或运行状态，并可能产生拨测额度或流量消耗。 | 建议在 Agent 客户端启用人工确认：执行前展示目标、节点、参数、频率、套餐及影响；执行后回读标识和状态。 |
三、如何使用本工具参考
四、建议调用链路
| 场景 | 调用链路 | 使用要点 |
|---|---|---|
| 告警排查 | 告警日志列表 → 告警汇总 → 节点级明细 | 先发现异常，再判断影响，最后定位异常节点。 |
| 即时监测 | 在线节点 → 发起监测 → 汇总 → 明细列表 → 单条详情 | 发起监测前校验节点，写操作前先展示参数和额度影响。 |
| 周期任务 | 字典 / 套餐 / 节点组 / 剩余量 → 创建 → 任务列表 / 状态 → 原始或元素数据 | 先完成标识、套餐和额度校验，再创建或变更持续运行任务。 |
五、MCP 资源
tingyun://synthetic/dictionaries/*调用规则： 资源为只读数据。后续工具调用应使用资源返回的标识，不应根据中文名称自行推断标识。
| 序号 | 资源 URI | 资源名称 | 访问 | 完整描述、访问要求与示例 |
|---|---|---|---|---|
| 1 | tingyun://synthetic/dictionaries/cities | 城市字典 | 只读 | 资源描述 读取拨测节点或拨测目标可用的城市字典，返回任务配置、告警筛选、创建节点组、查询即时监测在线节点和查看节点组等场景使用的城市标识与城市名称。该资源为只读数据；调用方应使用返回的城市标识作为后续工具参数，不应根据城市名称自行推断标识。 |
| 2 | tingyun://synthetic/dictionaries/isps | 运营商字典 | 只读 | 资源描述 读取拨测节点或拨测目标可用的运营商字典，返回任务配置、告警筛选、创建节点组、查询即时监测在线节点和查看节点组等场景使用的运营商标识与运营商名称。该资源为只读数据；调用方应使用返回的运营商标识作为后续工具参数，不应根据运营商名称自行推断标识。 |
六、告警工具集
/mcp/synthetic/alert工具集概览： 共 3 个工具：3 个只读工具，0 个写操作工具。具体可见范围和可执行操作取决于当前账户权限。
| 序号 | 工具方法 | 工具名称 | 操作 | 完整描述、权限与示例 |
|---|---|---|---|---|
| 1 | list_tingyun_synthetic_alert | 告警日志列表 | 只读 | 工具描述 查询当前账户可见的拨测告警日志列表。可按时间范围、任务类型和警报状态等维度筛选，返回告警摘要以及后续查询汇总或明细所需的告警标识；适用于发现近期异常，不用于获取单条告警的完整明细。该工具为只读操作。 |
| 2 | get_tingyun_synthetic_alert_summary | 告警详情页汇总数据 | 只读 | 工具描述 根据告警标识查询单条拨测告警的汇总信息， 包括影响范围、持续时间、异常节点和关键性能指标。适用于判断告警严重程度和总体影响；如需查看具体节点或探测结果，应继续调用 list_tingyun_synthetic_alert_detail_rows 工具。该工具为只读操作。 |
| 3 | list_tingyun_synthetic_alert_detail_rows | 告警详情页表格数据 | 只读 | 工具描述 根据告警标识查询单条拨测告警的节点级明细结果。用于定位异常来源；本工具返回拨测单样本数据列表，不替代告警汇总工具。该工具为只读操作。 |
七、即时监测工具集
/mcp/synthetic/instant工具集概览： 共 11 个工具：5 个只读工具，6 个写操作工具。具体可见范围和可执行操作取决于当前账户权限。
| 序号 | 工具 方法 | 工具名称 | 操作 | 完整描述、权限与示例 |
|---|---|---|---|---|
| 1 | list_tingyun_synthetic_online_probe | 在线节点列表 | 只读 | 工具描述 查询调用时刻可用于即时监测的在线拨测节点。返回节点标识、位置、运营商、类型，用于在发起即时监测前选择节点；节点状态可能随时间变化。该工具为只读操作。 |
| 2 | list_tingyun_synthetic_instant_test | 即时监测列表 | 只读 | 工具描述 查询当前账户的即时监测记录列表。可按目标地址、时间范围和任务类型筛选，返回即时监测标识、目标、类型、创建时间和执行状态等摘要；适用于查找历史记录，返回拨测样本数据列表。该工具为只读操作。 |
| 3 | get_tingyun_synthetic_instant_test_results | 即时监测汇总数据 | 只读 | 工具描述 根据一个即时监测标识查询汇总结果，返回各监测的可用性、响应时间和错误分布等摘要，用于查看目标当前质量。该工具只读取已有结果，不会发起新的监测；拨测样本数据列表定位应使用即时监测详情列表工具。该工具为只读操作。 |
| 4 | list_tingyun_synthetic_instant_test_details | 即时监测详情列表 | 只读 | 工具描述 根据即时监测标识查询拨测样本数据列表。可按分页返回，用于定位异常来源；返回的拨测单样本数据列表可用于继续查询单条完整详情。该工具为只读操作。 |
| 5 | get_tingyun_synthetic_instant_test_detail | 即时监测详情数据 | 只读 | 工具描述 根据即时监测明细标识查询单个拨测单样本数据列表的一次完整探测详情，包括请求和响应摘要、错误信息和性能指标。适用于对已定位的异常节点进行深入排查。该工具为只读操作。 |
| 6 | create_tingyun_synthetic_instant_test_page | 页面监测 | 写操作 | 工具描述 发起一次页面类型的即时监测，从所选在线节点访问指定页面 URL，并检测页面可用性、首屏以及 DNS、TCP、SSL 和响应时间等指标。调用会实际向外部目标发起探测并可能消耗拨测额度；提交前应确认目标 URL、节点和监测参数。创建成功后应返回即时监测标识和受理/执行状态，后续使用结果查询工具获取结果。 |
| 7 | create_tingyun_synthetic_instant_test_file | 文件监测 | 写操作 | 工具描述 发起一次文件下载类型的即时监测，从所选在线节点访问指定文件 URL，并检测可用性、下载速度、文件大小和响应耗时。调用会向外部目标下载数据并可能消耗拨测额度；提交前应确认目标 URL、节点和下载参数。创建成功后应返回即时监测标识和受理/执行状态，后续使用结果查询工具获取结果。 |
| 8 | create_tingyun_synthetic_instant_test_ping | Ping 监测 | 写操作 | 工具描述 发起一次 Ping 即时监测，从所选在线节点检测目标域名或 IP 的网络连通性、丢包率以及最小、最大和平均延迟。调用会向外部目标发送探测报文并可能消耗拨测额度；提交前应确认目标和节点。创建成功后应返回即时监测标识和受理/执行状态，后续使用结果查询工具获取结果。 |
| 9 | create_tingyun_synthetic_instant_test_streaming | 流媒体监测 | 写操作 | 工具描述 发起一次流媒体即时监测，从所选在线节点访问指定音视频流地址，并检测可用性、首帧时间、缓冲、卡顿和播放质量。调用可能产生实际拉流流量并消耗拨测额度；提交前应确认流地址、节点、协议和探测时长。创建成功后应返回即时监测标识和受理/执行状态。 |
| 10 | create_tingyun_synthetic_instant_test_mtr | MTR 监测 | 写操作 | 工具描述 发起一次 MTR 即时监测，从所选在线节点分析到指定目标域名或 IP 的网络路径、跳数、各跳延迟和丢包情况。调用会向外部网络发送路由探测并可能消耗拨测额度；提交前应确认目标、节点和探测参数。创建成功后应返回即时监测标识和受理/执行状态。 |
| 11 | create_tingyun_synthetic_instant_test_whois | Whois 监测 | 写操作 | 工具描述 发起一次域名 Whois 即时监测，查询指定域名的注册信息、到期时间、注册商、DNS 信息和注册状态，用于即时核查域名信息。调用可能消耗拨测额度，创建成功后应返回即时监测标识和受理/执行状态。 |
八、任务管理工具集
/mcp/synthetic/task工具集概览： 共 14 个工具：7 个只读工具，7 个写操作工具。具体可见范围和可执行操作取决于当前账户权限。
| 序号 | 工具方法 | 工具名称 | 操作 | 完整描述、权限与示例 |
|---|---|---|---|---|
| 1 | list_tingyun_synthetic_tasks | 任务列表 | 只读 | 工具描述 查询当前账户可见的拨测任务列表及基础配置。可按任务名称、ID 或套餐 ID 进行筛选，返回任务标识、名称、类型、状态和主要配置摘要，用于查找已有任务并为后续状态更新或数据查询取得任务标识。该工具为只读操作。 |
| 2 | update_tingyun_synthetic_task_status | 任务状态更新 | 写操作 | 工具描述 根据任务标识更新已有拨测任务的运行状态，用于启用、停用任务。该操作会修改线上任务并可能中断或恢复探测及额度消耗；执行前必须校验权限，并向用户展示任务名称、当前状态和目标状态以获得明确确认。工具应返回更新后的状态，不用于创建或删除任务。 |
| 3 | create_tingyun_synthetic_task_page | 页面监测 | 写操作 | 工具描述 创建页面监测任务，按配置的频率从指定节点组周期性访问页面 URL，并检测页面可用性、响应状态以及 DNS、TCP、SSL、首包和页面加载耗时。该操作会创建持续运行的线上任务并持续消耗拨测额度；提交前应确认任务名称、目标、节点组、频率、套餐和监测参数。创建成功后应返回任务标识。 |
| 4 | create_tingyun_synthetic_task_file | 文件监测 | 写操作 | 工具描述 创建文件下载监测任务，按配置的频率从指定节点组访问文件 URL，并检测可访问性、下载耗时、下载速度、文件大小、状态码和网络阶段耗时。该操作会创建持续运行的线上任务并产生周期性下载流量与额度消耗；提交前应确认目标、节点组、频率、套餐和下载参数。创建成功后应返回任务标识。 |
| 5 | create_tingyun_synthetic_task_ping | Ping 监测 | 写操作 | 工具描述 创建 Ping 监测任务，按配置的频率从指定节点组检测目标域名或 IP 的连通性、丢包率以及最小、最大和平均延迟。该操作会创建持续运 行的线上任务并持续消耗拨测额度；提交前应确认目标、节点组、频率、套餐和探测参数。创建成功后应返回任务标识。 |
| 6 | create_tingyun_synthetic_task_streaming | 流媒体监测 | 写操作 | 工具描述 创建流媒体监测任务，按配置的频率从指定节点组访问音视频流地址，并检测可用性、首帧时间、缓冲、卡顿和播放质量。该操作会创建持续运行的线上任务，可能产生周期性拉流流量并持续消耗额度；提交前应确认流地址、协议、节点组、频率、探测时长和套餐。创建成功后应返回任务标识。 |
| 7 | create_tingyun_synthetic_task_mtr | MTR 监测 | 写操作 | 工具描述 创建 MTR 监测任务，按配置的频率从指定节点组分析到目标域名或 IP 的网络路径、跳数、各跳延迟和丢包情况。该操作会创建持续运行的线上任务并持续消耗拨测额度；提交前应确认目标、节点组、频率、套餐和路由探测参数。创建成功后应返回任务标识。 |
| 8 | create_tingyun_synthetic_task_whois | 域名 Whois 监测 | 写操作 | 工具描述 创建域名 Whois 监测任务，按配置的频率查询域名注册信息、到期时间、注册商、DNS 信息和注册状态，用于持续发现域名过期、信息变更或状态异常。该操作会创建持续运行的线上任务并持续消耗拨测额度；提交前应确认域名、频率、套餐和告警条件。创建成功后应返回任务标识。 |
| 9 | get_tingyun_synthetic_usage | 使用量 | 只读 | 工具描述 查询指定时间范围内按日、按周等不同粒度的拨测使用量，返回统计结果，用于分析额度消耗趋势。该工具返回历史消耗，不代表当前剩余额度；如需判断能否继续创建或执行监测，应调用剩余额度工具。该工具为只读操作。 |
| 10 | get_tingyun_synthetic_remaining_quota | 剩余量 | 只读 | 工具描述 查询当前账户的剩余拨测额度，用于在创建任务、发起即时监测前进行额度校验。该工具只读取额度状态，不会预占额度，也不保证后续创建时额度仍未变化。 |
| 11 | list_tingyun_synthetic_packages | 套餐列表 | 只读 | 工具描述 查询当前账户可见的拨测套餐列表及其状态，返回创建任务所需的套餐标识、名称、有效期和状态摘要。适用于创建任务前选择并校验套餐；该工具不会预占或修改套餐额度。该工具为只读操作。 |
| 12 | list_tingyun_synthetic_probe_groups | 节点组列表 | 只读 | 工具描述 查询当前账户可见的拨测节点组列表及基础信息，返回任务创建所需的节点组标识、名称和节点摘要。适用于创建任务前选择或校验节点组；该工具不修改节点组。该工具为只读操作。 |
| 13 | get_tingyun_synthetic_raw_json | JSON 原始数据导出 | 只读 | 工具描述 查询指定拨测任务在指定时间范围内的原始 JSON 结果，用于问题复盘、证据留存或离线分析。单次最多返回 200 条，调用方应缩小时间范围以避免遗漏；该工具不适合全量批量导出，也不会修改任务或数据。 |
| 14 | list_tingyun_synthetic_page_resources | 元素数据导出 | 只读 | 工具描述 查询指定页面监测任务监测结果的元素级数据，包括资源 URL、资源类型、加载耗时和状态信息，用于分析页面性能瓶颈。该工具为只读列表查询。 |
九、反馈工具
/mcp/synthetic/task/mcp/synthetic/alert/mcp/synthetic/instant| 序号 | 工具方法 | 工具名称 | 操作 | 完整描述、权限与示例 |
|---|---|---|---|---|
| 1 | submitFeedback | 反馈工具 | 写操作 | 工具描述 提交反馈：当 AI 智能体遇到阻碍或发现某种模式行不通时使用，提交意图、尝试过程和遇到的问题。 |