Skip to main content
Glama
xiaohan815

MCP Browser Server

by xiaohan815

MCP Browser Server

浏览器自动化 MCP 服务器 - 兼容Claude Code 及其他支持 MCP 协议的工具。

功能特性

提供 30 个浏览器自动化工具:

类别

工具

导航

browser_navigate, browser_navigate_back, browser_navigate_forward, browser_reload

页面信息

browser_snapshot, browser_take_screenshot, browser_search, browser_highlight

交互

browser_click, browser_type, browser_fill, browser_fill_form, browser_hover, browser_select_option, browser_press_key, browser_scroll, browser_drag

信息获取

browser_get_attribute, browser_get_input_value, browser_get_bounding_box, browser_console_messages, browser_network_requests

状态检查

browser_is_visible, browser_is_enabled, browser_is_checked

等待

browser_wait_for

标签页

browser_tabs (list/new/close/switch)

窗口

browser_resize

安全

browser_lock, browser_unlock

对话框

browser_handle_dialog

Related MCP server: playwright-mcp-server

安装

cd /home/lpsadmin/work/mcp-cursor-ide-browser
npm install
npm run build

工具使用示例

导航操作

打开网页:
browser_navigate(url: "https://example.com")

后退/前进/刷新:
browser_navigate_back()
browser_navigate_forward()
browser_reload()

页面交互

点击元素:
browser_click(selector: "button.submit")

输入文字:
browser_type(selector: "input[name='username']", text: "admin")

清空并填入:
browser_fill(selector: "input[name='email']", text: "test@example.com")

批量填表:
browser_fill_form(fields: {
  "input[name='username']": "admin",
  "input[name='password']": "123456"
})

页面信息

获取页面快照(可访问性树):
browser_snapshot()

截图:
browser_take_screenshot(fullPage: true)

页面内搜索:
browser_search(query: "登录")

状态检查

检查元素是否可见:
browser_is_visible(selector: ".modal")

检查元素是否启用:
browser_is_enabled(selector: "button.submit")

检查复选框是否勾选:
browser_is_checked(selector: "input[type='checkbox']")

标签页管理

列出所有标签页:
browser_tabs(action: "list")

新建标签页:
browser_tabs(action: "new")

切换标签页:
browser_tabs(action: "switch", tabId: 1)

关闭标签页:
browser_tabs(action: "close", tabId: 2)

等待操作

等待文字出现:
browser_wait_for(text: "加载完成")

等待文字消失:
browser_wait_for(text: "加载中...", waitForGone: true)

等待指定时间:
browser_wait_for(timeout: 3000)

锁定/解锁

锁定浏览器(防止误操作):
browser_lock()

解锁浏览器:
browser_unlock()

环境要求

  • Node.js 16+

  • 支持的操作系统:Linux、macOS、Windows

技术栈

  • Puppeteer - 浏览器自动化

  • @modelcontextprotocol/sdk - MCP 协议支持

  • TypeScript - 类型安全

配置选项

默认使用 Headless 模式运行(无图形界面)。如需可视化模式,可修改 src/browser.ts 中的 headless 选项:

this.browser = await puppeteer.launch({
  headless: false,  // 改为 false 可启用可视化模式
  // ...
});

故障排除

1. 浏览器启动失败

错误信息:Missing X server or $DISPLAY

解决方案:确保使用 Headless 模式(默认已启用)。

2. 找不到模块

错误信息:Cannot find module

解决方案

cd /home/lpsadmin/work/mcp-cursor-ide-browser
npm install
npm run build

3. 权限问题

错误信息:EACCES: permission denied

解决方案

chmod +x /home/lpsadmin/work/mcp-cursor-ide-browser/dist/index.js

License

MIT

Related MCP Connectors

Related MCP Servers

  • A
    license
    C
    quality
    D
    maintenance
    A session-based MCP server that provides advanced browser automation capabilities, allowing users to control browsers, navigate websites, interact with elements, capture screenshots, generate PDFs, and manage cookies through natural language.
    35
    1
    MIT
  • A
    license
    Not graded
    quality
    D
    maintenance
    A fully local MCP server for browser automation using Playwright, providing 25 tools for navigation, content extraction, mouse, form, and keyboard interactions.
    1,199 npm
    MIT
  • A
    license
    Not graded
    quality
    D
    maintenance
    A Selenium-based MCP server that exposes browser automation tools for navigation, interaction, form filling, and assertions, enabling AI agents to control web browsers through natural language.
    GPL 3.0
  • F
    license
    Not graded
    quality
    B
    maintenance
    Standalone browser automation MCP server supporting both BrowserOS and standard Chrome. Enables 16 MCP tools for browser control including navigation, interaction, and content extraction.
    6 npm
    -