[BUG] Playwright MCP Server Issue on Arch Linux

Resolved 💬 4 comments Opened Aug 14, 2025 by ruffbuff Closed Jan 9, 2026

Bug Report: Playwright MCP Server Issue on Arch Linux

Environment

  • OS: Arch Linux
  • Tool: Claude Code CLI
  • MCP Server: Playwright

Problem Description

When using the Playwright MCP server with Claude Code CLI on Arch Linux, there's a critical system hang issue that occurs when the browser is not pre-installed.

Steps to Reproduce

  1. Use Arch Linux system
  2. Start Claude Code CLI
  3. Make any prompt that would invoke the Playwright MCP server
  4. Browser is not installed (typical for fresh Arch Linux installations)

Expected Behavior

  • The system should handle the missing browser gracefully
  • User should be able to install the browser or continue without it
  • CLI should remain responsive

Actual Behavior

  • Agent throws an error about missing browser
  • If process is not stopped within a few seconds, entire system becomes unresponsive:
  • Bot stops responding
  • CLI becomes unresponsive
  • Cannot exit or stop the process normally
  • Only solution is to kill the terminal forcefully

Impact

  • System becomes completely unusable
  • Forces user to kill terminal process
  • No graceful recovery possible once hang occurs

Suggested Fix

  • Add proper error handling for missing browser installations
  • Implement timeout mechanisms to prevent system hangs
  • Provide clear installation instructions when browser is missing
  • Allow graceful degradation when Playwright cannot initialize

Additional Notes

This issue appears to be specific to Arch Linux and may be related to how the Playwright MCP server handles browser installation checks or initialization failures on this distribution.

View original on GitHub ↗

This issue has 4 comments on GitHub. Read the full discussion on GitHub ↗