https://github.com/trebormc/ddev-playwright-mcp
DDEV Add-on: Headless Playwright browser (MCP)
https://github.com/trebormc/ddev-playwright-mcp
ddev ddev-get
Last synced: 2 months ago
JSON representation
DDEV Add-on: Headless Playwright browser (MCP)
- Host: GitHub
- URL: https://github.com/trebormc/ddev-playwright-mcp
- Owner: trebormc
- License: apache-2.0
- Created: 2026-03-25T13:59:29.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2026-04-15T10:54:33.000Z (2 months ago)
- Last Synced: 2026-04-15T12:30:46.615Z (2 months ago)
- Topics: ddev, ddev-get
- Language: Shell
- Size: 20.5 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
[](https://addons.ddev.com)
[](https://github.com/trebormc/ddev-playwright-mcp/actions/workflows/tests.yml?query=branch%3Amain)
[](https://github.com/trebormc/ddev-playwright-mcp/commits)
[](https://github.com/trebormc/ddev-playwright-mcp/releases/latest)
# ddev-playwright-mcp
A DDEV add-on that provides a [Playwright MCP](https://github.com/anthropics/playwright-mcp) server for headless browser automation via the Model Context Protocol. It gives AI agents a real Chromium browser to interact with your Drupal site: navigate pages, fill forms, take screenshots, and verify UI state programmatically.
> **Part of [DDEV AI Workspace](https://github.com/trebormc/ddev-ai-workspace)** — a modular ecosystem of DDEV add-ons for AI-powered Drupal development. Install the full stack with one command: `ddev add-on get trebormc/ddev-ai-workspace`
>
> Created by [Robert Menetray](https://menetray.com) · Sponsored by [DruScan](https://druscan.com)
> **Note:** This add-on is typically installed automatically as a dependency of [ddev-opencode](https://github.com/trebormc/ddev-opencode), [ddev-claude-code](https://github.com/trebormc/ddev-claude-code), or [ddev-ralph](https://github.com/trebormc/ddev-ralph). You rarely need to install it directly.
## Quick Start
The **recommended way** to install this add-on is through the [DDEV AI Workspace](https://github.com/trebormc/ddev-ai-workspace), which installs all tools and dependencies with a single command:
```bash
ddev add-on get trebormc/ddev-ai-workspace
ddev restart
```
This add-on is also **automatically installed** as a dependency when you install [ddev-opencode](https://github.com/trebormc/ddev-opencode), [ddev-claude-code](https://github.com/trebormc/ddev-claude-code), or [ddev-ralph](https://github.com/trebormc/ddev-ralph). You rarely need to install it directly.
### Standalone installation
If you need to install it individually (requires familiarity with the DDEV add-on ecosystem):
```bash
ddev add-on get trebormc/ddev-playwright-mcp
ddev restart
```
## What It Does
This add-on runs a **Playwright MCP server** as a DDEV service with headless Chromium. It exposes an MCP endpoint at `http://playwright-mcp:8931/mcp` accessible from other containers in the DDEV network.
Use cases:
- **AI-driven development**: Let AI agents (OpenCode, Claude Code) interact with your site through a real browser
- **Visual testing**: Take screenshots and verify UI state programmatically
- **Browser automation**: Automate form submissions, navigation, and interactions
## Usage
### From Other Containers
Connect to the MCP server at:
```
http://playwright-mcp:8931/mcp
```
### Screenshots
Screenshots are saved to the `screenshots/` directory in your project root, accessible from both the container and the host.
### Custom Image Version
To use a specific Playwright MCP image version:
```bash
ddev dotenv set .ddev/.env.playwright-mcp --playwright-mcp-image=mcr.microsoft.com/playwright/mcp:v1.2.0
ddev restart
```
## Configuration
| Variable | Default | Description |
|----------|---------|-------------|
| `PLAYWRIGHT_MCP_IMAGE` | `mcr.microsoft.com/playwright/mcp:latest` | Docker image to use |
| `TZ` | `UTC` | Timezone |
## Tips
- **Use HTTP** (not HTTPS) when navigating to your DDEV site from Playwright to avoid SSL certificate issues in local environments.
- The MCP server runs in **shared browser context** mode. Cookies and sessions persist across requests.
- Screenshots output directory: `/var/www/html/screenshots` (mapped to `./screenshots/` on host).
## Uninstallation
```bash
ddev add-on remove ddev-playwright-mcp
ddev restart
```
## Part of DDEV AI Workspace
This add-on is part of [DDEV AI Workspace](https://github.com/trebormc/ddev-ai-workspace), a modular ecosystem of DDEV add-ons for AI-powered Drupal development.
| Repository | Description | Relationship |
|------------|-------------|--------------|
| [ddev-ai-workspace](https://github.com/trebormc/ddev-ai-workspace) | Meta add-on that installs the full AI development stack with one command. | Workspace |
| [ddev-opencode](https://github.com/trebormc/ddev-opencode) | [OpenCode](https://opencode.ai) AI CLI container for interactive development. | Auto-installs this add-on |
| [ddev-claude-code](https://github.com/trebormc/ddev-claude-code) | [Claude Code](https://docs.anthropic.com/en/docs/claude-code) CLI container for interactive development. | Auto-installs this add-on |
| [ddev-ralph](https://github.com/trebormc/ddev-ralph) | Autonomous AI task orchestrator. Delegates work to OpenCode or Claude Code. | Auto-installs this add-on |
| [ddev-beads](https://github.com/trebormc/ddev-beads) | [Beads](https://github.com/steveyegge/beads) git-backed task tracker shared by all AI containers. | Sibling dependency |
| [ddev-agents-sync](https://github.com/trebormc/ddev-agents-sync) | Auto-syncs AI agent repositories into a shared Docker volume. | Sibling dependency |
| [ddev-ai-ssh](https://github.com/trebormc/ddev-ai-ssh) | SSH access to the web container for AI agents. | Sibling dependency |
| [drupal-ai-agents](https://github.com/trebormc/drupal-ai-agents) | 10 agents, 12 rules, 24 skills for Drupal development. Includes Playwright browser testing skill. | Uses this for visual testing |
## Disclaimer
This project is an independent initiative by [Robert Menetray](https://menetray.com), sponsored by [DruScan](https://druscan.com). It is not affiliated with Anthropic, OpenCode, Beads, Playwright, Microsoft, or DDEV. AI-generated code may contain errors. Always review changes before deploying to production.
## License
Apache-2.0. See [LICENSE](LICENSE).