Browser Use Mcp Server

Browser Use MCP 服务

一款快速、轻量的 Model Context Protocol（MCP）服务，通过 Puppeteer 的结构化辅助功能数据，为大模型提供浏览器自动化能力；支持可选视觉模式，可进行复杂视觉理解，并提供灵活的跨平台配置。

主要功能

• ⚡ 快速轻量。使用 Puppeteer 的标签索引，而非基于像素的输入和辅助功能 DOM 树。
• 👁️ 支持视觉模式。当结构化数据不足以应对复杂布局和视觉元素时，可选用视觉理解功能。
• 🤖 针对大模型优化。无需视觉模型，完全基于结构化数据运行，减少上下文，从而降低上下文令牌用量。
• 🧩 灵活的运行时配置。可通过 HTTP 标头在运行时自定义视口大小、坐标系比例因子和 User-Agent。
• 🌐 跨平台且可扩展。支持远程和本地浏览器，并可使用自定义浏览器引擎。

要求

• Node.js 18 或更高版本
• VS Code、Cursor、Windsurf、Claude Desktop 或其他 MCP 客户端

开始使用

本地（Stdio）

首先，使用你的客户端安装 Browser MCP 服务。典型配置如下：

{
  "mcpServers": {
    "browser": {
      "command": "npx",
      "args": [
        "@agent-infra/mcp-server-browser@latest"
      ]
    }
  }
}

# For VS Code
code --add-mcp '{"name":"browser","command":"npx","args":["@agent-infra/mcp-server-browser@latest"]}'

{
  "mcpServers": {
    "browser": {
      "command": "npx",
      "args": [
        "@agent-infra/mcp-server-browser@latest"
      ]
    }
  }
}

{
  "mcpServers": {
    "browser": {
      "command": "npx",
      "args": [
        "@agent-infra/mcp-server-browser@latest"
      ]
    }
  }
}

{
  "mcpServers": {
    "browser": {
      "command": "npx",
      "args": [
        "@agent-infra/mcp-server-browser@latest"
      ]
    }
  }
}

同时，使用 --port $your_port 参数启动浏览器 MCP，即可将其转换为 SSE 和 Streamable HTTP 服务。

# normal run remote mcp server
npx @agent-infra/mcp-server-browser --port 8089

# run with DISPLAY environment for VNC or other virtual display
DISPLAY=:0 npx @agent-infra/mcp-server-browser --port 8089

你可以使用以下两个 MCP 服务远程端点之一：

• Streamable HTTP（推荐）：http://127.0.0.1::8089/mcp
• SSE：http://127.0.0.1::8089/sse

然后在 MCP 客户端配置中，将 url 设置为 SSE 端点：

{
  "mcpServers": {
    "browser": {
      "url": "http://127.0.0.1::8089/sse"
    }
  }
}

将 url 设置为 Streamable HTTP 端点：

{
  "mcpServers": {
    "browser": {
      "type": "streamable-http", // If there is MCP Client support
      "url": "http://127.0.0.1::8089/mcp"
    }
  }
}

内存中调用

如果你的 MCP 客户端基于 JavaScript / TypeScript 开发，可以直接使用进程内调用，避免要求用户安装命令行界面才能使用 Browser MCP。

import { Client } from '@modelcontextprotocol/sdk/client/index.js';
import { InMemoryTransport } from '@modelcontextprotocol/sdk/inMemory.js';

// type: module project usage
import { createServer } from '@agent-infra/mcp-server-browser';
// commonjs project usage
// const { createServer } = await import('@agent-infra/mcp-server-browser')

const client = new Client(
  {
    name: 'test browser client',
    version: '1.0',
  },
  {
    capabilities: {},
  },
);

const server = createServer();
const [clientTransport, serverTransport] = InMemoryTransport.createLinkedPair();

await Promise.all([
  client.connect(clientTransport),
  server.connect(serverTransport),
]);

// list tools
const result = await client.listTools();
console.log(result);

// call tool
const toolResult = await client.callTool({
  name: 'browser_navigate',
  arguments: {
    url: 'https://www.google.com',
  },
});
console.log(toolResult);

配置

Browser MCP 服务支持以下参数。你可以将它们作为 "args" 列表的一部分，填入上述 JSON 配置中：

> npx @agent-infra/mcp-server-browser@latest -h
  -V, --version              output the version number
  --browser <browser>        browser or chrome channel to use, possible values: chrome, edge, firefox.
  --cdp-endpoint <endpoint>  CDP endpoint to connect to, for example "http://127.0.0.1:9222/json/version"
  --ws-endpoint <endpoint>   WebSocket endpoint to connect to, for example "ws://127.0.0.1:9222/devtools/browser/{id}"
  --executable-path <path>   path to the browser executable.
  --headless                 run browser in headless mode, headed by default
  --host <host>              host to bind server to. Default is localhost. Use 0.0.0.0 to bind to all interfaces.
  --port <port>              port to listen on for SSE and HTTP transport.
  --proxy-bypass <bypass>    comma-separated domains to bypass proxy, for example ".com,chromium.org,.domain.com"
  --proxy-server <proxy>     specify proxy server, for example "http://myproxy:3128" or "socks5://myproxy:8080"
  --user-agent <ua string>   specify user agent string
  --user-data-dir <path>     path to the user data directory.
  --viewport-size <size>     specify browser viewport size in pixels, for example "1280, 720"
  --output-dir <path>        path to the directory for output files
  --vision                   Run server that uses screenshots (Aria snapshots are used by default)
  -h, --help                 display help for command

运行时配置

浏览器运行时需要配置 Viewport Size、Vision Model Coordinate Factors 和 User Agent。这些配置可以通过对应的 HTTP 标头传递：

注意： 标头名称不区分大小写。

示例：

x-viewport-size: 1920,1080
x-vision-factors: 1.0,1.0
x-user-agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36

Docker

我们已将 VNC 和 MCP 的部署统一到单个 URL 端点下，Dockerfile 和 DockerHub 镜像也将一同发布！视频

API

工具

资源

开发

访问 http://127.0.0.1:6274/：

npm run dev

扩展 CLI 入口

#!/usr/bin/env node

const {
  BaseLogger,
  setConfig,
  addMiddleware,
} = require('@agent-infra/mcp-server-browser/request-context');

class CustomLogger extends BaseLogger {
  info(...args) {
    console.log('custom');
    console.log(...args);
  }
}

addMiddleware((req, res, next) => {
  console.log('req', req.headers);
  next();
});

setConfig({
  logger: new CustomLogger(),
});

// start server
require('@agent-infra/mcp-server-browser/index');