AI导哈

浏览器自动化MCP服务

一个基于Model Context Protocol (MCP)的服务，通过Vercel的agent-browser提供浏览器自动化能力，使LLM能够通过快速Rust CLI与Node.js回退与网页交互。

  • by softallice
  • TypeScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 softallice/agent-browser-mcp

使用说明

@nxavis/代理浏览器mcp

A. 模型上下文协议（MCP） 通过以下方式提供浏览器自动化功能的服务器 Vercel的代理浏览器这使得LLM能够使用具有Node.js回退的快速Rust CLI与网页进行交互。

快速开始

# 1. Install agent-browser CLI
npm install -g agent-browser && agent-browser install

# 2. Add to Claude Desktop (or your MCP client)
npx @nxavis/agent-browser-mcp

然后使用以下工具 browser_navigate, browser_click, browser_snapshot 从您的AI代理控制浏览器。

特性

  • AI优化浏览器控制 -使用可访问性属性、文本匹配和数据属性的语义元素定位器
  • 会话隔离 -多个独立的浏览器会话，具有单独的Cookie、存储和导航历史记录
  • 综合自动化 -导航、表单填写、点击、滚动、键盘输入等
  • 数据提取 -获取文本、HTML、属性、辅助功能快照、屏幕截图和PDF
  • Cookie管理 -完全控制浏览器Cookie和存储
  • JavaScript执行 -在浏览器上下文中运行任意脚本
  • 网络检查 -监控控制台消息和网络请求

安装

npm install @nxavis/agent-browser-mcp

或者直接使用npx运行：

npx @nxavis/agent-browser-mcp

先决条件

# Install agent-browser globally
npm install -g agent-browser

# Download Chromium browser
agent-browser install

# On Linux, install system dependencies if needed:
# agent-browser install --with-deps

⚠️ Windows注意事项： 代理浏览器当前具有 Windows上的已知问题 使用本机shell（PowerShell/CMD）。对于Windows用户，我们建议使用 WSL（Linux的Windows子系统） 直到上游问题得到解决。

配置

克劳德桌面版

添加到您的 claude_desktop_config.json:

macOS： ~/Library/Application Support/Claude/claude_desktop_config.json

窗户： %APPDATA%\Claude\claude_desktop_config.json

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

VS Code

添加到您的VS代码设置（JSON）：

{
  "mcp": {
    "servers": {
      "agent-browser": {
        "command": "npx",
        "args": ["@nxavis/agent-browser-mcp"]
      }
    }
  }
}

反重力

添加到您的 .mcp.json 项目根目录或主目录中的文件：

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

或者使用全局配置 ~/.mcp.json:

{
  "mcpServers": {
    "agent-browser": {
      "command": "npx",
      "args": ["@nxavis/agent-browser-mcp"],
      "env": {
        "AGENT_BROWSER_PATH": "/usr/local/bin/agent-browser"
      }
    }
  }
}

自定义代理浏览器路径

如果 agent-browser 不在PATH中，请指定其位置：

{
  "mcpServers": {
    "agent-browser": {
      "command": "npx",
      "args": ["@nxavis/agent-browser-mcp"],
      "env": {
        "AGENT_BROWSER_PATH": "/path/to/agent-browser"
      }
    }
  }
}

可用工具

导航

  • browser_navigate -导航到URL
  • browser_go_back -在浏览器历史记录中导航回来
  • browser_go_forward -在浏览器历史记录中向前导航
  • browser_reload -重新加载当前页面

交互

  • browser_click -点击一个元素
  • browser_fill -填写文本输入框
  • browser_type -逐个字符键入文本
  • browser_hover -将鼠标悬停在元素上
  • browser_scroll -滚动页面或特定元素
  • browser_select -从下拉列表中选择一个选项
  • browser_check -选中复选框或单选按钮
  • browser_uncheck -取消选中复选框
  • browser_press -按键盘键

数据提取

  • browser_get_text -从元素或页面获取文本内容
  • browser_get_html -获取HTML内容
  • browser_get_attribute -获取属性值
  • browser_get_url -获取当前页面URL
  • browser_get_title -获取当前页面标题
  • browser_snapshot -获取可访问性树快照

会话管理

  • browser_new_session -创建新的隔离浏览器会话
  • browser_close_session -关闭浏览器会话

屏幕截图和PDF

  • browser_screenshot -截图
  • browser_pdf -生成当前页面的PDF

有关工具及其参数的完整列表，请参阅 原始文件.

发展

# Clone the repository
git clone https://github.com/nxavis/agent-browser-mcp.git
cd agent-browser-mcp

# Install dependencies
npm install

# Build
npm run build

# Run tests
npm test

# Watch mode
npm run dev

许可证

麻省理工学院

学分

此软件包基于 代理浏览器mcp 由minhlucvan编写，适用于@nxavis生态系统。

相关 MCP