io.github.MathiasPaulenko/wavexis-mcp

MCP server — 220 browser automation tools for LLMs

Chrome + Firefox · CDP + BiDi · 100% Python · zero Node.js · zero Chromium download

English | 简体中文 | 日本語

MCP server that exposes the wavexis browser automation library to LLMs. 220 tools across 13 capability tiers. No Node.js, no Chromium download — uses your existing Chrome/Edge. 100% Python.

Quick demo

30 seconds to your first screenshot. Add this to your MCP client config (Claude Desktop, Cursor, Windsurf, VS Code):

{
  "mcpServers": {
    "wavexis": {
      "command": "uvx",
      "args": ["wavexis-mcp", "--caps", "all"]
    }
  }
}

Then ask your LLM:

"Take a full-page screenshot of https://example.com"

The LLM calls wavexis_screenshot(url="https://example.com", full_page=true) and returns the screenshot. No Node.js, no Chromium download, no setup beyond the config above.

Why WaveXisMCP?

WaveXisMCP wraps the wavexis browser automation library and exposes it as an MCP server. You don't need Node.js, Playwright, or a separate Chromium download — WaveXisMCP launches your existing Chrome or Edge installation directly.

Key features

• 220 tools — 3x more than Playwright MCP (21), 2x more than zendriver-mcp (96)
• 13 capability tiers — enable only what you need via --caps. Start with core (72 tools), add tiers as needed
• Chrome + Firefox — CDP for Chrome/Edge, BiDi for Firefox. Both auto-launch their drivers from PATH
• No Chromium download — uses your existing browser. ~5MB install vs ~400MB for Playwright MCP
• Stealth mode — stealth=true hides navigator.webdriver, fakes plugins/languages/chrome runtime
• Structured errors — every error includes a suggestion field so the LLM self-corrects without human help
• Multi-action YAML — chain navigate → click → fill → screenshot in a single tool call
• Raw CDP/BiDi access — escape hatch for any browser feature not covered by a dedicated tool
• Lighthouse audits, WebAuthn, Bluetooth, Cast — niche features no other MCP server covers
• SSRF protection, path sandboxing, rate limiting — security built in from day one
• 593 tests, 90% coverage enforced, E2E with real Chrome — production-ready

How it works

You (natural language)
  → LLM decides which tool to call
    → WaveXisMCP receives the tool call
      → wavexis library executes it via CDP or BiDi
        → Chrome/Edge/Firefox performs the action
 

... [View full README on GitHub](https://github.com/mathiaspaulenko/wavexis-mcp#readme)