
MCP Web Browser Server

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
: 导航到指定 URLextract_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")