能力

🌐 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": ["vision", "pdf", "devtools", "network", "storage", "testing"]
}

能力参考

🌐 Capability reference

核心（始终启用）

🌐 core (always enabled)

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

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

工具	描述
browser_navigate	导航到一个网址
browser_navigate_back	回到历史
browser_snapshot	捕获无障碍快照
browser_find	在快照中搜索文本或正则表达式
browser_click	点击一个元素
browser_hover	将鼠标悬停在一个元素上
browser_drag	在两个元素之间拖放
browser_drop	将文件或 MIME 类型的数据拖放到一个元素上
browser_select_option	选择下拉选项
browser_type	在元素中输入文本
browser_press_key	按一个键
browser_fill_form	填写多个表单字段
browser_take_screenshot	截屏
browser_run_code_unsafe	执行一个 Playwright 代码片段
browser_evaluate	评估 JavaScript
browser_wait_for	等待文本或时间
browser_handle_dialog	接受或关闭对话框
browser_file_upload	上传文件到文件选择器
browser_console_messages	获取控制台输出
browser_network_requests	列出网络请求
browser_network_request	完整显示一个请求的详细信息
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	管理 Cookie
browser_localstorage_list/get/set/delete/clear	管理 localStorage
browser_sessionstorage_list/get/set/delete/clear	管理 sessionStorage
browser_storage_state	保存 Cookie + 本地存储到文件
browser_set_storage_state	恢复已保存的状态

"--caps=storage"

testing

断言和定位器生成。

🌐 Assertions and locator generation.

工具	描述
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, action recording, highlighting, and debugging.

工具	描述
browser_start_tracing	开始执行跟踪
browser_stop_tracing	停止跟踪并保存
browser_start_video	开始录像
browser_stop_video	停止录像并保存
browser_video_chapter	添加章节卡片
browser_video_show_actions	给操作添加页面标注
browser_video_hide_actions	停止操作标注
browser_start_recording	以代码记录用户操作
browser_stop_recording	停止记录并返回代码
browser_highlight	在元素周围显示高亮覆盖
browser_hide_highlight	移除高亮覆盖
browser_annotate	打开 Playwright 仪表盘并收集用户标注
browser_resume	继续暂停的脚本执行

"--caps=devtools"

请查看 调试工具。

🌐 See Debugging Tools.

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

核心 + 网络用于模拟 + 存储用于 Cookie：

🌐 Core + network for mocking + 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.