markmircea/Selenix-MCP-Server

Connect Claude Desktop to Selenix via the Model Context Protocol. Chat with Claude to create, run, debug, and manage browser automation tests — just like using the built-in AI Assistant, but powered by Claude.
Prerequisites
- Selenix desktop app installed
- Claude Desktop installed
- Node.js 18 or later
Enable the Bridge in Selenix
Before using any setup method below, enable the bridge inside Selenix:
1. Open Selenix
2. Go to **System Settings** (gear icon in the sidebar)
3. Scroll to the **MCP Server** section
4. Set **Enable MCP Server** to **Yes**
This starts a local bridge server that the MCP server connects to.
Setup
Choose one of the following methods:
Option A: Install via npm (recommended)
Then find your global npm path:
Open your Claude Desktop config file:
- **Windows**: Press Win+R, paste %APPDATA%\Claude\claude_desktop_config.json, press Enter
- **macOS**: Open ~/Library/Application Support/Claude/claude_desktop_config.json
Add the Selenix MCP server, replacing the path with the output from npm root -g:
**Example (Windows with nvm):**
**Example (macOS/Linux):**
If you already have other MCP servers configured, add "selenix" alongside them inside the existing "mcpServers" object.
Option B: Use the bundled version (no npm required)
If you installed Selenix as a desktop app, the MCP server is already bundled. No need to install anything — just point Claude Desktop to the bundled file.
Find your Selenix install folder and look for resources/mcp-server/index.js, then add to your Claude Desktop config:
**Typical Windows path:**
Option C: Manual download
1. Download bundle.js from the npm package page or from the releases page
2. Save it somewhere on your machine (e.g., C:/selenix-mcp/bundle.js)
3. Add to your Claude Desktop config:
Node.js is still required — the MCP server is a single JavaScript file with no other dependencies.
Verify
Restart Claude Desktop after editing the config. You should see the Selenix tools icon (hammer) in the chat input area.
Try asking Claude:
- "What tests are in my Selenix project?"
- "Create a test that opens google.com and searches for 'selenium automation'"
- "Run the current test and fix any failures"
- "Take a screenshot of the browser"
How It Works
The MCP server translates Claude's tool calls into HTTP requests to a bridge server running inside Selenix. The bridge has full access to Selenix internals — the same capabilities as the built-in AI Assistant.
- The bridge only listens on 127.0.0.1 (localhost) — no network exposure
- Auth is handled via a bearer token auto-generated each time Selenix starts
- Connection config is stored at ~/.selenix/bridge.json and re-read on every call, so restarting Selenix does not require restarting Claude Desktop
Available Tools
Reading & Inspection
| Tool | Description |
|------|-------------|
| get_screenshot | Capture a screenshot of the browser window |
| get_page_html | Get the page HTML with interactive elements annotated |
| get_search_html | Search page HTML by regex pattern |