How do I use nix-playwright-mcp?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@nix-playwright-mcp Navigate to https://example.com and return the page title" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

A Nix Flake for Playwright MCP

Deprecated: This repository was a workaround for complex usage in the former Playwright MCP server. This is no longer necessary in the current version of Playwright MCP, which can be run simply using npx.

This repository now only provides a Nix-wrapped version of the Playwright MCP server, with the browser executable set to Chromium from Nixpkgs. I am still maintaining this repository for personal use, but it doesn't offer much benefit.

For a comprehensive framework for running MCP servers on NixOS, I would recommend the following options:

https://github.com/natsukium/mcp-servers-nix
https://github.com/aloshy-ai/nix-mcp-servers
https://github.com/cameronfyfe/nix-mcp-servers

Usage

Run the server:

nix run github:akirak/nix-playwright-mcp

or in headless mode:

nix run github:akirak/nix-playwright-mcp -- --headless

Credits

To initially make Playwright run on NixOS, I followed a thread on the NixOS Discourse. The posts by Patrizio Bekerle, a.k.a. pbek, and Giacomo Debidda, a.k.a. jackdbd, were especially helpful. Thanks!