Helm Browser

Helm浏览器

通过MCP对AI编码助手进行浏览器控制。你真正的Chrome，而不是无头实例。

npx skills add jfikrat/helm-browser

亮点

• 约57个工具，涵盖导航、阅读、交互、脚本编写、状态和多目标控制
• 用于调试器变异命令的具有每个选项卡序列化的持久调试器会话
• 语义定位器通过 browser_get_snapshot() 和 locator 支持稳定元素瞄准
• 对iframe、弹出窗口和对话框的多目标支持

为什么是Helm？

大多数浏览器自动化工具都会启动一个单独的无头Chromium。Helm采用了一种不同的方法：它控制 您的实际Chrome 通过轻量级的扩展。

支持的客户

• 克劳德代码 -Anthropic的CLI
• Codex CLI -OpenAI
• Gemini CLI 谷歌
• 帮助 -AI配对编程
• 任何兼容MCP的客户端

建筑

┌─────────────────┐     ┌─────────────────┐     ┌─────────────────┐
│   AI Client     │────▶│   Helm Daemon   │────▶│ Chrome Extension│
│ (Claude, etc.)  │ WS  │   (Port 9876)   │ WS  │   (Side Panel)  │
└─────────────────┘     └─────────────────┘     └─────────────────┘

• 扩展：带侧面板UI的Chrome扩展程序
• 守护进程：端口9876上的WebSocket协调器
• 服务器：MCP服务器公开浏览器工具
• 客户：用于AI助手的MCP客户端

快速开始

先决条件

• 铬或铬

1.安装

git clone https://github.com/jfikrat/helm-browser.git
cd helm-browser
./install.sh

2.加载Chrome扩展程序

1. 首选 chrome://extensions
2. 启用 开发人员模式
3. 点击 装载时未包装 → 选择 extension/ 文件夹

install.sh 如果需要，安装Bun，运行 bun install 在 daemon/, server/，以及 client/，并将守护进程注册为用户服务(systemd 在Linux上， launchd 在macOS上）。重新运行是安全的。

要稍后删除服务和已安装的依赖项，请执行以下操作：

./uninstall.sh

3.配置MCP

添加到您的MCP配置中（例如。， ~/.claude/claude.json):

{
  "mcpServers": {
    "helm": {
      "command": "bun",
      "args": ["run", "/path/to/helm-browser/client/index.ts"]
    }
  }
}

工具

导航

阅读

交互

目标与调试

高级

例子

Web剪贴

> Navigate to Hacker News, get the top 3 story titles

browser_navigate("https://news.ycombinator.com")
browser_get_element_text(".titleline > a")

表单自动化

> Log into my dashboard

browser_navigate("https://app.example.com/login")
browser_type("[name='email']", "user@example.com")
browser_type("[name='password']", "secret")
browser_click("[type='submit']")

多标签研究

> Open GitHub trending and compare top 2 repos

browser_navigate("https://github.com/trending")
browser_get_element_text("article.Box-row:first-child h2 a")
browser_click("article.Box-row:first-child h2 a")
browser_screenshot()

语义定位

> Use stable refs instead of brittle selectors

browser_get_snapshot()
browser_click({ "ref": "e42" })
browser_type({ "label": "Email address" }, "user@example.com")

会话隔离

每个MCP客户端都有自己的隔离浏览器窗口。侧面板显示活动会话，并允许手动选项卡布线。

发展

cd daemon && bun run --watch start   # Daemon with hot reload
cd server && bun run --watch start   # Server with hot reload
cd client && bun run --watch start   # Client with hot reload

许可证

麻省理工学院-见 许可证