Playwright MCP Server
Browser automation via the Model Context Protocol. Supports headless Playwright, Chrome Extension bridge, and Firefox Extension bridge for controlling existing browser tabs.
Quick Start
npm install
npx playwright install chromium
npm run build
node dist/index.js
Extension Bridges
Link the MCP agent to your existing browser tabs. Two extensions are provided:
Chrome Extension (extension/)
Uses chrome.debugger API (CDP) for full browser control.
- Go to
chrome://extensions→ Load unpacked → selectextension/ - Start the MCP server:
node dist/index.js - Click the extension icon → Connect
- Use
extension_*tools
Firefox Extension (extension-firefox/)
Uses WebExtensions API with content scripts (no CDP dependency).
- Go to
about:debugging#/runtime/this-firefox→ Load Temporary Add-on → selectextension-firefox/manifest.json - Start the MCP server:
node dist/index.js - Click the extension icon → Connect
- Use
firefox_*tools
Extension Tools
Shared (Chrome + Firefox)
| Tool | Description |
|---|---|
extension_connect |
Check extension connection status |
extension_evaluate |
Execute JavaScript in the tab |
extension_screenshot |
Capture a screenshot of the tab |
extension_get_tabs |
List all open browser tabs |
extension_attach_tab |
Attach to a specific tab by ID |
Chrome CDP Tools
| Tool | Description |
|---|---|
extension_navigate |
Navigate the connected tab to a URL |
extension_click |
Click an element by CSS selector |
Firefox Content Script Tools
| Tool | Description |
|---|---|
firefox_navigate |
Navigate the connected tab to a URL |
firefox_click |
Click an element by CSS selector |
firefox_type |
Type text into an input field |
firefox_fill |
Fill an input field with a value |
firefox_get_text |
Get text content of an element |
firefox_get_html |
Get HTML content of page or element |
firefox_hover |
Hover over an element |
firefox_select |
Select an option in a select element |
firefox_check |
Check a checkbox |
firefox_uncheck |
Uncheck a checkbox |
firefox_get_attribute |
Get an attribute value from an element |
firefox_get_url |
Get the current page URL |
firefox_get_title |
Get the current page title |
firefox_go_back |
Navigate back in history |
firefox_go_forward |
Navigate forward in history |
firefox_reload |
Reload the current page |
firefox_scroll |
Scroll the page |
firefox_screenshot |
Take a screenshot of the connected tab |
firefox_evaluate |
Execute JavaScript in the connected tab |
Headless Mode (Default)
25+ browser_* tools for headless Chromium via Playwright.
Configuration
| Env Var | Default | Description |
|---|---|---|
MCP_WS_PORT |
9223 |
WebSocket port for extension bridge |
MCP_USE_EXTENSION |
false |
Set to true to require extension mode |
