MCP Web Browser Server

MCP Web Browser Server

site icon
2025.03.10 14
Python无头浏览器网页自动化浏览器自动化
MCP Web Browser Server 是一个基于 Playwright 的高级无头浏览器服务,专为 Model Context Protocol (MCP) 设计。它提供了一个灵活且安全的 API,用于实现无头浏览器交互,包括网页导航、内容提取、多标签管理、网页交互工具等功能。
View on GitHub

Overview

基本能力

产品定位

MCP Web Browser Server 是一个高级的无头浏览器服务,旨在通过 API 提供灵活的网页浏览和交互能力。

核心功能

  • 无头网页浏览:支持绕过 SSL 证书验证的网页导航
  • 完整页面内容提取:包括动态加载的 JavaScript 内容
  • 多标签支持:创建、管理和切换多个浏览器标签
  • 高级网页交互工具
  • 提取文本内容
  • 点击页面元素
  • 在表单字段中输入文本
  • 捕获屏幕截图
  • 提取页面链接并支持过滤
  • 页面滚动
  • 执行 JavaScript
  • 刷新页面
  • 等待导航完成
  • 资源管理:自动清理未使用的资源
  • 增强的页面信息:获取详细的页面元数据

适用场景

  • 网页内容抓取和分析
  • 自动化测试
  • 网页交互模拟
  • 多标签网页管理
  • 动态内容提取

工具列表

  • browse_to: 导航到指定 URL
  • extract_text_content: 提取文本内容
  • click_element: 点击页面元素
  • get_page_screenshots: 获取页面截图
  • get_page_links: 获取页面链接
  • input_text: 在输入框中输入文本
  • create_new_tab: 创建新标签
  • switch_tab: 切换标签
  • list_tabs: 列出所有标签
  • close_tab: 关闭标签
  • refresh_page: 刷新页面
  • get_page_info: 获取页面信息
  • scroll_page: 滚动页面
  • wait_for_navigation: 等待导航完成
  • execute_javascript: 执行 JavaScript

常见问题解答

  • SSL 证书错误:自动绕过
  • 页面加载缓慢:调整 browse_to() 方法的超时时间
  • 元素未找到:仔细验证选择器
  • 浏览器资源使用:自动清理不活动的资源

使用教程

使用依赖

  • Python 3.10+
  • MCP SDK
  • Playwright

安装教程

# Install MCP and Playwright
pip install mcp playwright

# Install browser dependencies
playwright install

调试方式

# Browse to a website
page_content = browse_to("https://example.com")

# Extract page text
text_content = extract_text_content()

# Extract text from a specific element
title_text = extract_text_content("h1.title")

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。