Skip to main content
Glama
Leviathangk

Playwright MCP Server

by Leviathangk

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

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

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

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