feat: integrate official Microsoft Playwright MCP server

[atxtechbro]

Overview

Add support for the official Microsoft Playwright MCP server (microsoft/playwright-mcp) to our dotfiles setup.

Motivation

Following our "Subtraction Creates Value" principle, we should use the official Microsoft implementation rather than maintaining our own custom Playwright MCP server. This will:

1. Reduce maintenance burden
2. Ensure we stay up-to-date with the latest features and fixes
3. Align with our approach of using vendor-provided MCP servers where available (similar to our recent migration to @zereight/mcp-gitlab)

Implementation Details

Installation

Add a setup script (mcp/setup-playwright-mcp.sh) that:

• Installs the official package: npm install -g @microsoft/playwright-mcp
• Verifies the installation
• Configures any necessary environment variables

Integration

Create a wrapper script (mcp/playwright-mcp-wrapper.sh) that:

• Executes the official MCP server
• Handles any necessary environment setup
• Provides appropriate error handling and logging

Configuration

Update mcp/mcp.json to register the Playwright MCP server:

{
  "mcpServers": {
    // existing servers...
    "playwright": {
      "command": "playwright-mcp-wrapper.sh",
      "args": [],
      "env": {
        "FASTMCP_LOG_LEVEL": "ERROR"
      }
    }
  }
}

Documentation

• Add usage examples to README.md
• Document available tools and capabilities
• Include troubleshooting information

Testing

• Verify installation works on both macOS and Linux
• Test basic Playwright functionality through MCP
• Ensure compatibility with both Claude Code and Amazon Q

Related Work

• Similar to our recent migration from custom GitLab MCP server to @zereight/mcp-gitlab in PR fix: remove gitlab mcp technical debt #949

References

• microsoft/playwright-mcp
• Playwright Documentation