Reticle

Name: Reticle
Author: reticlehq

本地服务

reticle.sh开发工具1.3k今天更新

代码仓库访问官网

关于 Reticle

Reticle 的桥接程序和 MCP 服务，用于让编码 Agent 检查正在运行的 Web 应用。应用通过浏览器 SDK 连接本地 WebSocket 端点，Agent 可读取、操作并断言应用状态。

主要功能

01连接应用的本地 WebSocket 桥接
02提供导航、观察和交互工具
03支持断言与操作后等待
04通过工具名称调用未公开工具
05可选公开完整工具列表

适用场景

01验证运行中应用的页面状态
02执行操作并观察应用响应
03对应用行为运行断言

MCP 相关

通过 stdio 暴露 MCP 工具，并自动启动本地桥接；应用的 `@reticlehq/browser` SDK 连接该桥接。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "reticlehq-reticle": {
      "command": "npx",
      "args": [
        "-y",
        "@reticlehq/server"
      ]
    }
  }
}

启动命令npx -y @reticlehq/server

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npm@reticlehq/server3.8.2stdio

工具

收录的工具列表 · 更新于 1 天前

参数	类型	必填	说明
url	string	否	要导航到的 URL。
hard	boolean	否	使用 reload:true 时，绕过浏览器缓存（Cmd+Shift+R）。
reload	boolean	否	重新加载当前页面，而不是导航到其他页面（取代之前独立的刷新工具）。
sessionId	string	否	指定目标标签页。除非你指的是特定标签页，否则请省略 — 请参阅说明。
timeout_ms	integer	否	等待页面恢复的时长（SDK 在新 URL 重新连接，或重新加载时在同一 ID 下重新连接），超时后再返回 confirmed:false。

详细介绍

@reticlehq/server

Reticle 桥接器 + MCP 服务。它会托管一个本地主机 WebSocket 端点，供你应用中的 @reticlehq/browser SDK 连接，并提供 MCP 工具，让你的编码 Agent 检查、操作、观察实时应用并针对它进行断言。

npx @reticlehq/server init   # wire the project: SDK + build plugin + MCP registration
npx @reticlehq/server mcp    # MCP over stdio; auto-starts the bridge on ws://localhost:4400

该软件包会安装一个 reticle 可执行文件，因此在项目中，reticle mcp 和 npx @reticlehq/server mcp 是同一条命令。reticle 不是 npm 上的软件包名称。

将 Agent 指向它。在 Claude Code 中，将它注册到用户级别：

claude mcp add reticle -s user -- npx @reticlehq/server mcp

默认工具（10 个）：

reticle_navigate、reticle_look、reticle_act、reticle_act_and_wait、reticle_observe、reticle_assert、reticle_session、reticle_tools、reticle_run、reticle_verify。

只有 reticle_act_and_wait 和 reticle_assert 会返回判定结果；其他工具都会操作或读取应用。

软件包还提供了更多工具，但不会主动公开，以缩减每轮对话中的工具负载：屏幕截图和视觉差异、已保存的流程、录制、基线、时钟控制、视口、爬取、覆盖率、网络模拟、租约等。可通过 reticle_run 按名称调用这些工具，通过 reticle_tools 列出它们，或设置 RETICLE_ADVERTISE_ALL_TOOLS=1 来公开全部工具（这会使每轮对话中的工具负载大致翻倍）。

请参阅主 README。

许可证

FSL-1.1-ALv2（源代码可用：可免费用于任何用途，但不得转售 Reticle 本身；两年后转换为 Apache-2.0）。dist/features/ee/ 下的文件属于企业功能，受 Reticle 企业许可证约束——可免费用于开发、测试和评估；在生产环境中使用这些功能需通过许可证密钥激活。

支持 Markdown

登录后评论