`playwright-mcp-server` 是一个基于 Playwright 的多浏览器控制协议（MCP）服务，允许通过 HTTP 接口远程控制浏览器实例。以下是使用 Python 调用 `playwright-mcp-server` 的步骤和示例代码： --- ### **1. 启动 playwright-mcp-server** 首先确保已安装 `playwright-mcp-server` 并启动服务： ```bash npm install -g playwright-mcp-server playwright-mcp-server --port 3000 ``` 默认监听 `http://localhost:3000`。 --- ### **2. Python 调用示例** 通过 `requests` 库与 MCP 服务交互，控制浏览器行为。 #### **示例代码** ```python import requests import json # MCP 服务地址 MCP_SERVER = "http://localhost:3000" # 1. 创建浏览器实例 def create_browser(): response = requests.post(f"{MCP_SERVER}/browser/new", json={"browser": "chromium"}) return response.json()["browserId"] # 2. 在指定浏览器中打开新页面 def new_page(browser_id): response = requests.post(f"{MCP_SERVER}/browser/{browser_id}/page/new") return response.json()["pageId"] # 3. 导航到页面并截图 def navigate_and_screenshot(browser_id, page_id, url, output_path): # 导航到URL requests.post( f"{MCP_SERVER}/browser/{browser_id}/page/{page_id}/navigate", json={"url": url} ) # 等待加载完成 requests.post( f"{MCP_SERVER}/browser/{browser_id}/page/{page_id}/wait", json={"state": "load"} ) # 截图 screenshot = requests.get( f"{MCP_SERVER}/browser/{browser_id}/page/{page_id}/screenshot", stream=True ) with open(output_path, "wb") as f: f.write(screenshot.content) # 4. 关闭浏览器 def close_browser(browser_id): requests.delete(f"{MCP_SERVER}/browser/{browser_id}") # 使用示例 if __name__ == "__main__": browser_id = create_browser() page_id = new_page(browser_id) navigate_and_screenshot(browser_id, page_id, "https://example.com", "example.png") close_browser(browser_id) ``` --- ### **3. 关键 API 说明** | 接口路径 | 方法 | 功能 | |----------------------------------------------|------|--------------------------| | `/browser/new` | POST | 创建新浏览器实例 | | `/browser/{browserId}/page/new` | POST | 在浏览器中打开新页面 | | `/browser/{browserId}/page/{pageId}/navigate`| POST | 导航到指定URL | | `/browser/{browserId}/page/{pageId}/wait` | POST | 等待页面状态（如加载完成）| | `/browser/{browserId}/page/{pageId}/screenshot`| GET | 截取页面截图 | | `/browser/{browserId}` | DELETE | 关闭浏览器实例 | --- ### **4. 高级用法** #### **并行控制多个浏览器** ```python browsers = [create_browser() for _ in range(3)] # 创建3个浏览器实例 for browser_id in browsers: page_id = new_page(browser_id) navigate_and_screenshot(browser_id, page_id, "https://example.com", f"output_{browser_id}.png") close_browser(browser_id) ``` #### **执行 JavaScript 代码** ```python def execute_js(browser_id, page_id, script): response = requests.post( f"{MCP_SERVER}/browser/{browser_id}/page/{page_id}/evaluate", json={"expression": script} ) return response.json()["result"] # 示例：获取页面标题 title = execute_js(browser_id, page_id, "document.title") print("Page Title:", title) ``` --- ### **5. 注意事项** 1. **服务可用性**：确保 `playwright-mcp-server` 已启动且端口正确。 2. **错误处理**：添加 `try-except` 处理网络请求异常。 3. **资源释放**：操作完成后及时关闭浏览器实例，避免内存泄漏。 ---