rootbrowse-mcp 0.1.1

MCP server for RootBrowse browser automation

RootBrowse MCP

MCP Server for RootBrowse browser automation framework. 为 AI Agent 提供结构化的浏览器操控能力。

安装

pip install rootbrowse-mcp

Claude Code 配置

在 settings.json 中添加：

{
  "mcpServers": {
    "rootbrowse": {
      "command": "rootbrowse-mcp"
    }
  }
}

或指定路径：

{
  "mcpServers": {
    "rootbrowse": {
      "command": "D:\\path\\to\\.venv\\Scripts\\python.exe",
      "args": ["-m", "rootbrowse_mcp.server"]
    }
  }
}

Tools

页面扫描

• get_page_regions() — 获取页面所有语义区域
• get_region_summary(region_id) — 获取区域统计摘要
• match_element(region_id, tag, role, text_contains, query, limit) — 按条件筛选元素
• get_element(ref) — 获取元素完整信息

元素操作

• click_element(ref) — 点击元素
• input_text(ref, text, clear) — 向输入框输入文字
• send_enter() — 发送回车键

浏览器

• init_browser(headless) — 初始化浏览器（必选，headless 默认 True）
• get_page(url, timeout) — 打开 URL
• take_screenshot(path) — 页面截图
• close_browser() — 关闭浏览器

注意： 使用其他工具前必须先调用 init_browser() 初始化浏览器。

标签页

• new_tab(url) — 打开新标签页
• close_tab() — 关闭当前标签页
• switch_tab(index) — 切换标签页
• get_tabs_count() — 获取标签页数量

状态

• save_state(path) — 保存浏览器状态
• load_state(path) — 恢复浏览器状态

依赖

• Python >= 3.10
• rootbrowse >= 0.2.0
• mcp >= 1.0.0