Skip to main content
Glama

desirecore_cdp

Read-onlyIdempotent

Retrieve page layout, DOM nodes, selectors, box models, and accessibility tree via read-only CDP methods on DesireCore. No arbitrary scripts or navigation.

Instructions

只允许页面布局、DOM、可访问性树的只读白名单 CDP 方法。不允许任意 JS、导航、Network、Fetch、Browser 或 Target 命令。

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
methodYes必须匹配此 Schema 的完整 CDP 方法名。
paramsNo传递给该 CDP 方法的参数对象;不得传入 sessionId 或顶层路由参数。
targetIdYes由 desirecore_list_windows 返回的确切 targetId;不默认挑窗口。
instanceIdYes由 desirecore_list_instances 返回的本次运行 instanceId;实例重启后必须重新列举并选择,不接受端口或路径。

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observedv1.3.0

TDQS

A3.6/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

注释已提供readOnlyHint、idempotentHint等,但描述额外具体列出了禁止的命令类别(Network、Fetch、Browser、Target等),这比注释更详细地揭示了工具的边界行为。虽然未新增其他副作用说明,但该列表有助于代理理解不会执行哪些操作,与注释一致且补充了细节。

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

描述仅一句话,但完整传达了核心限制(只读白名单、禁止命令列表),无冗余内容。信息密度高,且关键约束(只读、禁止命令)位于开头,便于快速理解。

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

工具较简单,参数和枚举已由schema完整定义,注释覆盖了安全属性。描述虽未说明返回格式,但CDP方法本身具有标准返回结构,且输出schema不存在,因此无需额外解释。整体信息足以让代理正确调用,仅缺少对返回内容的明确说明,但影响不大。

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

输入模式对每个参数都有描述(如instanceId要求32位hex,targetId必须来自list_windows),覆盖率达100%。描述本身未添加参数层面的新信息,仅重申了白名单概念,因此基于schema覆盖给予基准3分。

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

描述明确指出该工具用于只读白名单CDP方法,并列举了允许的领域(页面布局、DOM、可访问性树)和禁止的命令类型(任意JS、导航等)。虽然动词'允许'略显间接,但结合schema中的method枚举,能够清楚区分于兄弟工具(如截图、列表)。

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

描述没有提供明确的'何时使用'或'何时不用'的指导,也没有提及替代工具。它仅通过禁止列表暗示了不适用场景(如需要JS执行时),但未说明应使用哪个替代工具,也没有提供使用前置条件(如必须先列举实例和窗口)。

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.