Echo

Echo 是一款运行在你计算机上的桌面浏览器。它暴露了一个 MCP 服务器，因此 Cursor、Claude Desktop、ChatGPT/Codex、Continue、Cline、Windsurf、VS Code 以及其他 MCP 客户端可以使用你现有的订阅来驱动它。

没有模型 API，也没有云端 Chromium。你看到的浏览器窗口就是助手所控制的那个。

快速开始（给你的朋友）

1. 在你的计算机上安装 Echo（Windows、Mac 或 Linux —— 见下文）。

2. 让 Echo 保持运行。 关闭窗口会将其隐藏；它会继续在托盘（Windows/Linux）或菜单栏（Mac）中运行。

3. 打开 设置（⋮ 菜单，右上角）→ 连接。

4. 点击 Cursor、Claude 或 ChatGPT/Codex 下的 连接。

5. 完全退出并重新打开该 AI 应用，以便它识别 Echo。

6. 让助手搜索网页或打开页面 —— 它应该会使用 Echo 的工具（navigate、snapshot、search_web 等）。

同一台计算机上的 MCP URL：http://127.0.0.1:18931/mcp
服务器名称：echo
设置 → 连接中会显示一个 Bearer 令牌（Echo 在首次启动时创建）。

Related MCP server: agentify-desktop

下载

安装程序： GitHub Releases

为你的操作系统选择文件：

如果 Releases 页面为空，维护者需要发布一个版本标签（例如 v1.0.0），这样 GitHub Actions 才能构建安装程序。在此之前，请使用下方的从源码运行。

仓库： https://github.com/krishngohel/local-browser

安装 — Windows

1. 从 Releases 下载适合你 CPU 的安装程序：

   • 大多数 PC：Echo-Setup-*-x64.exe

   • ARM 笔记本电脑（Surface Pro X、Snapdragon、Copilot+ PC）：Echo-Setup-*-arm64.exe — 不要在 ARM 上使用 x64 版本。

2. 运行安装程序。Windows SmartScreen 可能会发出警告，因为该构建未签名：

   • 点击 更多信息 → 仍要运行。

3. 完成向导。Echo 会安装到 %LOCALAPPDATA%\Programs\Echo\，并添加桌面和开始菜单快捷方式。

4. 安装完成后 Echo 会打开。让它保持运行。

5. 关闭窗口不会退出 Echo — 它会隐藏到系统托盘（时钟旁边）。右键点击那里的 Echo 图标可显示或退出。

打开设置： 点击 ⋮ 菜单（右上角）→ 连接。

卸载： Windows 设置 → 应用 → Echo。你的浏览配置文件会保留在 %APPDATA%\Echo 中，除非你手动删除该文件夹。

安装 — Mac

1. 从 Releases 下载 Echo-1.0.0-mac-universal.dmg。

2. 打开 .dmg。将 Echo 拖到 应用程序。

3. 弹出磁盘映像。 不要继续从挂载的 .dmg 中使用 Echo — 弹出后它将无法工作。如果你从磁盘映像启动，Echo 会发出警告。

4. 从应用程序中打开 Echo。

5. 首次启动 — Gatekeeper： 该应用未签名（还没有 Apple Developer ID）。macOS 会阻止正常的双击：

   • 右键点击 Echo → 打开 → 打开。

   • 在 macOS Sequoia 或更高版本上，如果需要：系统设置 → 隐私与安全性 → 仍要打开。

6. 让 Echo 保持运行。 红色关闭按钮隐藏窗口；Echo 会保留在** Dock** 和菜单栏（右上角）中。

   • 再次显示：点击 Dock 图标、菜单栏图标，或 Echo → 显示 Echo。

   • 退出：Echo → 退出 Echo、Cmd+Q，或菜单栏图标 → 退出。

打开设置： ⋮ 菜单 → 连接。

如果你使用 Claude Desktop： 从 nodejs.org 安装 Node.js（LTS）。从 Dock 启动的 Claude 无法看到 Homebrew 的 PATH；当你点击连接时，Echo 会写入 Node 的完整路径。

配置文件文件夹： ~/Library/Application Support/Echo

防火墙（可选）： 如果 Wi-Fi 上的另一台设备无法连接，请在系统设置 → 网络 → 防火墙中允许 Echo。

安装 — Linux

1. 从 Releases 下载 Echo-1.0.0-linux-x64.AppImage。

2. 使其可执行并运行：

chmod +x Echo-1.0.0-linux-x64.AppImage
./Echo-1.0.0-linux-x64.AppImage

3. 让 Echo 保持运行（系统托盘）。从 ⋮ 菜单打开设置 → 连接。

配置文件文件夹： ~/.config/Echo（或打包应用的 Electron userData 路径）。

防火墙（可选）： 如果局域网上的另一台设备需要连接，请允许 TCP 端口 18931（或设置中显示的端口）。

连接你的 AI

Echo 必须在连接前运行。打开设置（⋮）→ 连接。

MCP 服务器旁边的绿点表示 Echo 正在监听。如果需要手动复制此计算机 URL：http://127.0.0.1:18931/mcp。

Cursor

1. 在 Echo 中：点击 Cursor 下的连接。

2. Echo 会写入 ~/.cursor/mcp.json（将任何现有文件备份到 mcp.json.bak）。

3. 在 Cursor 中：设置 → MCP — 如果 echo 显示为禁用，请启用它。

4. 开始新的聊天。助手应该能看到 Echo 工具（navigate、snapshot、search_web 等）。

Claude Desktop

连接不会热插拔。 Echo 会写入一个配置文件；Claude 只在启动时读取它。

1. 在 Echo 中：点击 Claude Desktop 下的连接（Echo 必须正在运行）。

2. Echo 会写入 Claude 的配置：

   • Mac：~/Library/Application Support/Claude/claude_desktop_config.json

   • Windows：%APPDATA%\Claude\claude_desktop_config.json

   • Linux：~/.config/Claude/claude_desktop_config.json

3. 完全退出 Claude Desktop — 这是大多数人遗漏的步骤：

   • Mac：Cmd+Q（点击红色按钮不够）

   • Windows：右键点击系统托盘中的 Claude → 退出

4. 让 Echo 保持运行（托盘 / 菜单栏）。

5. 重新打开 Claude。

6. 在 Claude 中：设置 → 开发者 → 本地 MCP 服务器 — 确认 echo 已列出。聊天中的锤子图标表示 MCP 工具已激活。

打包版 Echo（v1.0.1+） 使用 Echo 本身作为桥接 — 不需要 Node.js。

不要使用 Claude 的“添加自定义连接器” — 那仅适用于公共 HTTPS 服务器。

如果仍然失败，请参阅下方的Claude 无法连接。

ChatGPT / Codex 桌面版

1. 在 Echo 中：点击 ChatGPT / Codex 下的连接。

2. Echo 会写入 ~/.codex/config.toml（备份到 config.toml.bak）。

3. 完全退出并重新打开 ChatGPT 桌面版或 Codex。

注意： 普通浏览器中的 chatgpt.com 无法访问你计算机上的 Echo，除非你设置自己的 HTTPS 隧道。

任何其他 MCP 客户端

在同一个设置页面上，复制以下之一：

• HTTP（此计算机） — Cursor、Continue、Cline、Windsurf、VS Code 等。

• stdio（此计算机） — 仅支持基于命令的 MCP 的客户端。

• 此网络 — 如果 AI 客户端在 Wi-Fi 上的另一台设备上运行（使用你计算机的局域网 IP；仍然需要 bearer token）。

将 JSON/TOML 粘贴到该客户端的 MCP 配置中。请完全按照显示的方式包含 Authorization: Bearer … 标头。

验证是否有效

1. Echo 正在运行（托盘 / 菜单栏）。

2. 设置 → 连接显示 MCP 服务器正在监听。

3. 你的 AI 应用在连接后完全重启。

4. 询问类似这样的内容：“在 Google 上搜索 Echo browser MCP，并在 Echo 中打开第一个结果。”

助手应该会调用 search_web、navigate 和 snapshot 等工具。如果工具缺失，请检查 echo 是否在客户端的 MCP 设置中启用，并重新连接。

验证码 / 登录 / 2FA： 在 Echo 窗口中自行完成。告诉助手 wait_for，然后继续。

日常使用

登录时打开： 设置 → 系统 → 登录时打开（在后台隐藏启动）。

下载、截图、录制： 设置 → 系统 → 打开文件夹。

令牌使用： 设置 → 传输 — 如果希望减少令牌，请在连接时关闭页面照片、观看帧或技能树。更改工具组后重新连接 AI 客户端。

从源码运行（开发者）

需要 Node.js 20+。

git clone https://github.com/krishngohel/local-browser.git
cd local-browser
npm install
npm run dev

这会编译应用并打开 Electron 窗口。Playwright 通过 CDP（端口 9333）连接到同一个 Chromium。你不需要单独安装浏览器。

在你的机器上构建安装程序：

npm run dist

你不能从 Windows 构建 Mac .dmg — 这需要 Mac 或 GitHub Actions 在 macos-latest 上运行。

在 Windows 上，运行 npm run dist 后，npm run start-menu 会将 Echo 添加到开始菜单，而无需重新运行安装向导。

故障排除

“Echo 已在运行”

只应运行一个 Echo 实例（MCP 端口冲突）。在托盘（Windows/Linux）或菜单栏（Mac）中找到 Echo。从那里退出，然后只打开一次 Echo。

Claude 无法连接

连接保存一个文件 — 它不会为你重启 Claude。

1. Claude 启动时 Echo 必须正在运行（Windows 托盘，Mac 菜单栏）。

2. 完全退出 Claude，而不仅仅是关闭聊天窗口：

   • Mac：Cmd+Q

   • Windows：托盘图标 → 退出

3. 重新打开 Claude。检查设置 → 开发者 → 本地 MCP 服务器中是否有 echo。

4. 在 Echo 设置 → 连接中，状态应从“已保存到 Claude”变为已连接（绿色），一旦 Claude 的桥接生效。

5. 在 v1.0.0 上，安装 Node.js 并再次点击连接。v1.0.1+ 不需要 Node — 从 Releases 更新。

6. Claude 日志（如果需要）：Mac ~/Library/Logs/Claude/，Windows %APPDATA%\Claude\logs\。

Cursor / Claude 看不到 Echo（一般情况）

• Echo 必须在 AI 应用启动之前运行（或在 Echo 启动后重启 AI 应用）。

• 在设置 → 连接中再次点击连接。

• 完全退出 Cursor 或 Claude（而不仅仅是关闭聊天窗口），然后重新打开。

• Cursor：设置 → MCP → 启用 echo。

• Claude：使用本地 MCP 服务器，而不是“添加自定义连接器”。

Claude 提示缺少 Node.js

从 https://nodejs.org 安装 Node，然后在 Echo 中再次点击连接，以便它写入正确的路径。

Mac：“无法打开 Echo” / “已损坏”

右键点击 → 打开，或系统设置 → 隐私与安全性 → 仍要打开。对于未签名的应用来说这是正常的。

Mac：从磁盘映像打开

将 Echo 拖到应用程序，弹出 .dmg，从应用程序中打开。

SmartScreen / Gatekeeper 警告

在添加代码签名证书之前，安装程序是未签名的。使用上述步骤 — 该应用是从本仓库的 GitHub Actions 构建的。

Google 显示验证码或同意页面

在 Echo 窗口中完成验证。让助手等待（wait_for）并重试。

Wi-Fi 上的另一台设备无法连接

使用设置中的 This network URL 和令牌。在主机电脑的防火墙中允许 Echo 通过专用网络。请勿公开分享令牌。

MCP 端口被占用

Echo 优先使用端口 18931，并依次尝试 18931–18940。端口 8931 会被避开（Playwright MCP 默认端口）。请查看设置中的实际 URL。

Windows ARM 笔记本电脑（Surface、Snapdragon）

请使用 Echo-Setup-*-arm64.exe，而不是 x64 安装程序。x64 版本在模拟环境下可能安装失败、崩溃或行为异常。从 v1.0.2 版本开始包含原生 ARM64 Windows 构建。设置 → 系统 → 关于 → 系统类型 应显示 基于 ARM64 的电脑。

Echo 为助手提供的内容

连接时，Echo 会发送一份技能树（如何浏览、搜索、截图、录制等），除非你在设置 → 传输中将其关闭。

浏览： tabs_list、tabs_new、tabs_close、tabs_select、navigate、back、reload、snapshot、screenshot、watch、click、type、fill、press、scroll、select、wait_for

搜索 / 提取： search_web、extract_readable

调试： console_errors、network_failures

测试： viewport_set、test_start、test_assert_text、test_assert_url、test_end

录制 / 回放： record_start、record_stop、recordings_list、recording_play、recording_delete

在执行 click / type / fill 之前，务必先执行 snapshot。引用看起来像 e0、e1。

完整指南：skills/ECHO-SKILL-TREE.md

安全（请阅读）

• 你在 Echo 中登录的任何内容，在 MCP 连接期间对已连接的助手都是可见的。

• MCP 监听此电脑和你的局域网（0.0.0.0:18931，或下一个可用端口）。同一台机器上的客户端应使用 127.0.0.1。

• Bearer 令牌保护 MCP 服务器。当你连接时，Echo 会将其写入 Cursor/Claude 配置中。请勿在网上发布该令牌。

• Echo 使用与你日常 Chrome 独立的配置文件——不是你的常规浏览器 Cookie。

• 下载：应用数据文件夹 → downloads/。录制：recordings/。

法律

• 隐私政策

• 服务条款

• MIT 许可证

应用内也有：设置 → 关于、隐私、条款。

构建 / 发布（维护者）

GitHub Actions（.github/workflows/release.yml）在 v* 标签上构建 Windows、Mac 和 Linux 安装程序（例如 git tag v1.0.0 && git push origin v1.0.0）。手动 运行工作流 会将产物上传到 Actions 运行记录中，但不会创建 Release 页面。

除非配置了签名密钥，否则 Mac 和 Windows 构建版本未签名。