Skip to main content
Glama
Leviathangk

Playwright MCP Server

by Leviathangk
OverviewSchemaRelated ServersScoreDiscussions
TypeScript
Local

Playwright MCP Server

基于 Playwright 的 Model Context Protocol (MCP) 服务器，提供浏览器自动化功能。

  • 会话管理：创建和管理多个独立的浏览器会话

  • 并发支持：支持多个并发浏览器会话，自动清理过期会话

  • 浏览器操作：导航、点击、输入等常用操作

  • 灵活配置：支持不同浏览器（Chromium、Firefox、WebKit）和模式（有头/无头）

  • 自动清理：会话超时后自动清理资源

npm 地址：https://www.npmjs.com/package/@leviathangk/playwright-mcp

GitHub 地址：https://github.com/Leviathangk/PlaywrightMCPForCrawler

安装

npm i @leviathangk/playwright-mcp

MCP 配置

在 MCP Server 中添加：

{ "mcpServers": { "playwright": { "command": "node", "args": [ "@leviathangk/playwright-mcp@latest", "--browser", "chromium", "--headless", "false", "--session-timeout", "300000", "--max-sessions", "10" ] } } }

配置参数

参数

默认值

说明

--browser

chromium

浏览器类型：chromium、firefox、webkit

--headless

false

无头模式

--session-timeout

300000

会话超时（毫秒）

--max-sessions

10

最大并发会话数

--executable-path

无

浏览器可执行路径（可选）

核心工具

浏览器安装

  • browser_install - 安装 Playwright 浏览器（chromium、firefox、webkit）

会话管理

  • browser_create_session - 创建会话

  • browser_close_session - 关闭会话

页面管理（多标签页）

  • browser_get_pages - 获取所有打开的页面列表

  • browser_new_page - 创建新页面（标签页）

  • browser_switch_page - 切换到指定页面

  • browser_close_page - 关闭指定页面

页面操作

  • browser_navigate - 导航到 URL

  • browser_click - 点击元素

  • browser_type - 输入文本

  • browser_scroll - 滚动页面

  • browser_wait_for_element - 等待元素出现

  • browser_execute_script - 执行自定义 JavaScript

页面分析

  • browser_get_page_structure - 获取页面结构

  • browser_find_element_by_text - 根据文本查找元素

  • browser_query_selector - 使用 CSS 选择器查询元素

  • browser_get_page_content - 获取页面内容（HTML/文本/Markdown）

  • browser_get_text_content - 获取元素文本内容

  • browser_screenshot - 截图

网络请求捕获

  • browser_search_requests - 搜索请求（支持正则）

  • browser_get_requests - 获取所有请求

  • browser_get_request_detail - 获取请求详情（含 curl）

  • browser_clear_requests - 清空请求历史

使用示例

基础使用

// 1. 创建会话 const session = await callTool('browser_create_session'); // 2. 导航到页面 await callTool('browser_navigate', { sessionId: session.sessionId, url: 'https://example.com' }); // 3. 搜索 API 请求 const results = await callTool('browser_search_requests', { sessionId: session.sessionId, keyword: 'api/data', searchIn: ['url'] }); // 4. 获取请求详情 const detail = await callTool('browser_get_request_detail', { sessionId: session.sessionId, requestId: results.matches[0].id }); // 5. 关闭会话 await callTool('browser_close_session', { sessionId: session.sessionId });

多标签页管理

// 获取所有页面 const pages = await callTool('browser_get_pages', { sessionId: sessionId }); console.log(`总共 ${pages.totalPages} 个页面`); pages.pages.forEach(page => { console.log(`${page.index}: ${page.title} ${page.isActive ? '(当前)' : ''}`); }); // 创建新页面 await callTool('browser_new_page', { sessionId: sessionId, url: 'https://www.example.com' }); // 切换到指定页面 await callTool('browser_switch_page', { sessionId: sessionId, pageIndex: 1 }); // 关闭页面 await callTool('browser_close_page', { sessionId: sessionId, pageIndex: 2 });

页面分析

// 获取页面结构 const structure = await callTool('browser_get_page_structure', { sessionId: sessionId, maxElements: 50 }); // 查找元素 const element = await callTool('browser_find_element_by_text', { sessionId: sessionId, text: '登录' }); // 点击元素 await callTool('browser_click', { sessionId: sessionId, selector: element.selector }); // 获取页面内容 const content = await callTool('browser_get_page_content', { sessionId: sessionId, format: 'html' }); // 执行自定义脚本 const result = await callTool('browser_execute_script', { sessionId: sessionId, script: 'return document.title;' });

常见浏览器路径

Windows:

  • Chrome: C:\Program Files\Google\Chrome\Application\chrome.exe

  • Edge: C:\Program Files (x86)\Microsoft\Edge\Application\msedge.exe

macOS:

  • Chrome: /Applications/Google Chrome.app/Contents/MacOS/Google Chrome

  • Edge: /Applications/Microsoft Edge.app/Contents/MacOS/Microsoft Edge

Linux:

  • Chrome: /usr/bin/google-chrome

  • Chromium: /usr/bin/chromium-browser

This server cannot be installed

-
security - not tested
F
license - not found
-
quality - not tested

How are these scores calculated?

Resources

New MCP Servers

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/Leviathangk/PlaywrightMCPForCrawler'

If you have feedback or need assistance with the MCP directory API, please join our Discord server