Kagami

Provides a Playwright MCP server with JWT-protected external access for browser automation in Claude Code Web.

python

0

GitHub Stars

python

Language

5 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "takeru-kagami": {
      "command": "python3",
      "args": [
        "playwright_mcp_claude_code_web/mcp.py"
      ]
    }
  }
}

You can run a Playwright MCP server that lets you automate browser tasks through a JWT-authenticated proxy, all integrated with Claude Code Web. This server framework ensures browser automation via Playwright, secure external access, and automatic setup to get you started quickly.

How to use

You will configure an MCP client to launch the Playwright MCP server, then Claude Code will handle starting and managing the server for you. Once running, requests from your MCP client are proxied to the Playwright MCP server, which launches Firefox as needed and routes traffic through the authentication proxy. Your workflows can automate browser actions while benefiting from TLS inspection via a dedicated Firefox profile.

How to install

Prerequisites: You need Python 3.x installed on your system (or environment) where the MCP server will run. You also need a compatible environment that can execute Python and launch the Playwright MCP workflow.

Configuration and usage notes

The MCP server is started by your client configuration. A typical configuration entry directs Claude Code to run the Python entry point for the MCP server.

{
  "mcpServers": {
    "playwright": {
      "command": "python3",
      "args": [
        "playwright_mcp_claude_code_web/mcp.py"
      ]
    }
  }
}

Additional notes

Automatic setup is performed on first startup to install required components, create necessary Firefox profiles, and import CA certificates for TLS inspection within the Claude Code Web environment. Expect a brief startup period as the system configures itself.

Security considerations

All HTTPS traffic is routed through a JWT-authenticated proxy for external access. A dedicated Firefox profile is used to ensure TLS inspection and secure browsing within the environment.

Troubleshooting

If setup appears to be in progress for an extended period, verify that the MCP entry point is reachable and that the underlying Python environment has network access to install dependencies and fetch required components.

Available tools

autoSetup

Automatically installs required components on first startup, including certutil, @playwright/mcp, Firefox, and CA certificates, and generates the configuration.

jwtProxyAccess

External access is mediated through a JWT authentication proxy to secure communications.

firefoxAutomation

Automates browser actions using Firefox as the browser engine for Playwright MCP.

caCertificateImport

Imports a CA certificate into the Firefox profile to enable TLS inspection within the controlled environment.

mcpProxy

Proxies all MCP requests through the local Playwright MCP setup to the external proxy layer.