Browser MCP Extension

浏览器mcp扩展

通过MCP（模型上下文协议）和HTTP API实现浏览器自动化，由Chrome扩展+Go二进制提供支持。

该系统有三个组成部分：

• Chrome扩展程序（MV3）： 将脚本注入网页，并通过WebSocket与Go二进制文件通信。
• 转到二进制： 公开用于AI代理的MCP服务器（stdio）和用于curl/脚本的HTTP API。
• JS脚本： 页面级自动化脚本（单击、键入、导航、观察等）。

先决条件

• 转到1.24+
• 铬或铬

快速开始

# Build the binary
make build

# Wrap JS scripts into the extension (required before first run)
make sync-scripts

加载Chrome扩展程序

1. 打开 chrome://extensions/ 在Chrome浏览器中
2. 启用“开发人员模式”
3. 点击“加载解包”并选择 extension/ 目录

扩展通过配置端口上的WebSocket连接到Go二进制文件。 在任何MCP工具或HTTP端点工作之前，必须加载并连接扩展。

运行模式

# MCP server on stdio (for AI agents)
make mcp

# HTTP API + WebSocket server (for curl/scripting)
make serve

使用Claude代码进行设置

创建一个 .mcp.json 要使用浏览器自动化的项目中的文件：

{
  "mcpServers": {
    "browser-automation": {
      "command": "/absolute/path/to/browser-mcp-extension/browser-cmd",
      "args": ["--mcp"]
    }
  }
}

替换 /absolute/path/to/browser-mcp-extension/browser-cmd 以及构建二进制文件的实际路径。然后重新启动Claude Code以启动MCP服务器。

配置

所有配置都是通过环境变量进行的。看 env.example 对于违约。

MCP工具

在MCP模式下运行时可用的工具(./browser-cmd --mcp):

HTTP API

HTTP API绑定到 127.0.0.1 只有。终点：

发展

make test    # Unit tests
make vet     # Go vet
make e2e     # E2E tests (runs headful Chromium via playwright-go)
make clean   # Remove binary, observations, wrapped scripts
make help    # Show all available commands