能力

🌐 Capabilities

功能控制 MCP 服务器向 LLM 提供的工具。默认情况下，仅启用核心工具。添加功能以解锁其他工具组。

🌐 Capabilities control which tools the MCP server exposes to the LLM. By default, only core tools are enabled. Add capabilities to unlock additional tool groups.

启用功能

🌐 Enabling capabilities

通过 CLI 参数：

🌐 Via CLI argument:

{
  "mcpServers": {
    "playwright": {
      "command": "npx",
      "args": ["@playwright/mcp@latest", "--caps=vision,pdf,devtools"]
    }
  }
}

通过环境变量：

🌐 Via environment variable:

PLAYWRIGHT_MCP_CAPS=vision,pdf,devtools

通过配置文件：

🌐 Via config file:

{
  "capabilities": ["core", "vision", "pdf", "devtools", "network", "storage", "testing"]
}

能力参考

🌐 Capability reference

核心（始终启用）

🌐 core (always enabled)

基本浏览器自动化 — 始终可用，无法禁用。

🌐 Basic browser automation — always available, cannot be disabled.

工具	描述
browser_navigate	导航到 URL
browser_navigate_back	返回历史记录
browser_snapshot	捕获无障碍快照
browser_click	点击元素
browser_hover	悬停在元素上
browser_drag	拖放
browser_select_option	选择下拉选项
browser_type	在元素中输入文本
browser_press_key	按下按键
browser_fill_form	填写多个表单字段
browser_take_screenshot	截取屏幕截图
browser_run_code	执行 Playwright 代码
browser_wait_for	等待文本/时间
browser_evaluate	执行 JavaScript
browser_handle_dialog	接受/取消对话框
browser_file_upload	上传文件
browser_console_messages	获取控制台输出
browser_network_requests	列出网络请求
browser_tabs	管理标签页
browser_close	关闭浏览器
browser_resize	调整窗口大小

network

网络模拟和状态控制。

🌐 Network mocking and state control.

工具	描述
browser_route	模拟匹配 URL 模式的请求
browser_route_list	列出活动的模拟路由
browser_unroute	移除模拟路由
browser_network_state_set	设置在线/离线状态

"--caps=network"

storage

Cookie、本地存储和会话存储管理以及状态持久化。

🌐 Cookie, localStorage, and sessionStorage management plus state persistence.

工具	描述
browser_cookie_list/get/set/delete/clear	管理 cookies
browser_localstorage_list/get/set/delete/clear	管理 localStorage
browser_sessionstorage_list/get/set/delete/clear	管理 sessionStorage
browser_storage_state	将 cookies + localStorage 保存到文件
browser_set_storage_state	恢复已保存的状态

"--caps=storage"

testing

断言和测试生成工具。

🌐 Assertions and test generation tools.

工具	描述
browser_verify_element_visible	通过角色和名称断言元素可见
browser_verify_text_visible	断言文本可见
browser_verify_list_visible	断言包含条目的列表可见
browser_verify_value	断言表单字段的值
browser_generate_locator	为测试代码生成 Playwright 定位器

"--caps=testing"

vision

基于坐标的鼠标工具，用于截图驱动的工作流。需要具备视觉能力的语言模型。

🌐 Coordinate-based mouse tools for screenshot-driven workflows. Requires a vision-capable LLM.

工具	描述
browser_mouse_move_xy	将鼠标移动到坐标
browser_mouse_click_xy	在坐标点击
browser_mouse_drag_xy	在坐标间拖动
browser_mouse_down	按下鼠标按钮
browser_mouse_up	释放鼠标按钮
browser_mouse_wheel	滚动鼠标滚轮

"--caps=vision"

有关使用模式，请参见 Vision Mode。

🌐 See Vision Mode for usage patterns.

pdf

PDF 生成。

🌐 PDF generation.

工具	描述
browser_pdf_save	将页面导出为 PDF

"--caps=pdf"

devtools

跟踪、视频录制和测试调试。

🌐 Tracing, video recording, and test debugging.

工具	描述
browser_start_tracing	开始执行跟踪
browser_stop_tracing	停止跟踪并保存
browser_start_video	开始视频录制
browser_stop_video	停止视频并保存
browser_video_chapter	添加章节标记
browser_resume	恢复暂停的执行

"--caps=devtools"

config

配置自省。

🌐 Configuration introspection.

工具	描述
browser_get_config	获取解析后的配置

"--caps=config"

常见配置

🌐 Common configurations

最小（默认）

🌐 Minimal (default)

仅核心工具——导航、快照、点击、打字、截图：

🌐 Only core tools — navigation, snapshots, clicking, typing, screenshots:

["@playwright/mcp@latest"]

全自动化

🌐 Full automation

全部启用：

🌐 Everything enabled:

["@playwright/mcp@latest", "--caps=network,storage,testing,vision,pdf,devtools"]

测试工作流程

🌐 Testing workflow

核心 + 测试断言 + 用于身份验证持久化的存储：

🌐 Core + testing assertions + storage for auth persistence:

["@playwright/mcp@latest", "--caps=testing,storage"]

调试工作流程

🌐 Debugging workflow

用于跟踪和视频的核心 + 开发工具：

🌐 Core + devtools for tracing and video:

["@playwright/mcp@latest", "--caps=devtools"]

数据提取

🌐 Data extraction

用于 API 检查的核心 + 网络 + 用于存储 cookie：

🌐 Core + network for API inspection + storage for cookies:

["@playwright/mcp@latest", "--caps=network,storage"]

为什么能力存在

🌐 Why capabilities exist

能力限制了向大型语言模型暴露的工具数量。工具越少意味着：

🌐 Capabilities limit the number of tools exposed to the LLM. Fewer tools means:

• 更低的令牌成本 — 工具模式更小
• 更少的虚假工具调用 — 大语言模型有更少的选项会混淆
• 更快的响应 — 处理的上下文更少

只启用你用例所需的功能。

🌐 Only enable what you need for your use case.