Which integrations are available for this server?

Allows GitHub Copilot to control a browser for web automation tasks such as navigation, clicking, form filling, and screenshots.

How do I use IRA-RESEARCHER?

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., "@IRA-RESEARCHER open google.com, search for 'MCP server', and return the first result" 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.

🔬 IRA-RESEARCHER — Browser Automation MCP Server

The most powerful browser automation MCP server — 40 tools, 7 ghost effects, stealth mode, and full DevTools access.

✨ Features

40 tools — navigation, interaction, vision, tabs, DevTools, utility, health
👻 Ghost effects — floating action panel, click ripples, typing glow, drag arrows, scroll indicators, screenshot flash
🛡️ Stealth mode — puppeteer-extra anti-detection
🌐 Auto proxy rotation — random proxy from a pool
🔧 Full DevTools — console, network, elements, styles, performance, storage, accessibility audit
🏃 Auto browser launch — no Chrome extension needed
🔑 Zero API keys — no LLM dependency

📋 Quick Start

1. Install

cd IRA-RESEARCHER
npm install
npx puppeteer browsers install chrome

2. Add to Any MCP Client

Replace C:\\path\\to\\IRA-RESEARCHER with the actual path to this folder.

.cursor/mcp.json — add to the mcpServers object:

{
  "mcpServers": {
    "ira-researcher": {
      "command": "node",
      "args": ["C:\\path\\to\\IRA-RESEARCHER\\src\\index.js"],
      "env": {
        "IRA_HEADLESS": "false",
        "IRA_WINDOW": "maximize",
        "IRA_GHOST": "true"
      }
    }
  }
}

Run in terminal:

claude mcp add ira-researcher node C:\path\to\IRA-RESEARCHER\src\index.js --env IRA_HEADLESS=false --env IRA_WINDOW=maximize --env IRA_GHOST=true

Or manually edit ~/.claude/mcp.json:

{
  "mcpServers": {
    "ira-researcher": {
      "command": "node",
      "args": ["C:\\path\\to\\IRA-RESEARCHER\\src\\index.js"],
      "env": {
        "IRA_HEADLESS": "false",
        "IRA_WINDOW": "maximize",
        "IRA_GHOST": "true"
      }
    }
  }
}

~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "ira-researcher": {
      "command": "node",
      "args": ["C:\\path\\to\\IRA-RESEARCHER\\src\\index.js"],
      "env": {
        "IRA_HEADLESS": "false",
        "IRA_WINDOW": "maximize",
        "IRA_GHOST": "true"
      }
    }
  }
}

Project root opencode.json:

{
  "mcp": {
    "ira-researcher": {
      "command": "node",
      "args": ["C:\\path\\to\\IRA-RESEARCHER\\src\\index.js"],
      "env": {
        "IRA_HEADLESS": "false",
        "IRA_WINDOW": "maximize",
        "IRA_GHOST": "true"
      }
    }
  }
}

.vscode/mcp.json:

{
  "servers": {
    "ira-researcher": {
      "command": "node",
      "args": ["C:\\path\\to\\IRA-RESEARCHER\\src\\index.js"],
      "env": {
        "IRA_HEADLESS": "false",
        "IRA_WINDOW": "maximize",
        "IRA_GHOST": "true"
      }
    }
  }
}

VS Code Settings → Extensions → Cline → MCP Servers → Add:

{
  "ira-researcher": {
    "command": "node",
    "args": ["C:\\path\\to\\IRA-RESEARCHER\\src\\index.js"],
    "env": {
      "IRA_HEADLESS": "false",
      "IRA_WINDOW": "maximize",
      "IRA_GHOST": "true"
    }
  }
}

.windsurfrules or MCP settings:

{
  "mcpServers": {
    "ira-researcher": {
      "command": "node",
      "args": ["C:\\path\\to\\IRA-RESEARCHER\\src\\index.js"],
      "env": {
        "IRA_HEADLESS": "false",
        "IRA_WINDOW": "maximize",
        "IRA_GHOST": "true"
      }
    }
  }
}

.aider.conf.yml:

mcp-servers:
  ira-researcher:
    command: node
    args:
      - "C:\\path\\to\\IRA-RESEARCHER\\src\\index.js"
    env:
      IRA_HEADLESS: "false"
      IRA_WINDOW: "maximize"
      IRA_GHOST: "true"

Or via CLI:

aider --mcp-server ira-researcher node C:\path\to\IRA-RESEARCHER\src\index.js

~/.config/zed/settings.json → add to context_servers:

{
  "context_servers": {
    "ira-researcher": {
      "command": "node",
      "args": ["C:\\path\\to\\IRA-RESEARCHER\\src\\index.js"],
      "env": {
        "IRA_HEADLESS": "false",
        "IRA_WINDOW": "maximize",
        "IRA_GHOST": "true"
      }
    }
  }
}

Any MCP-compatible tool uses this JSON:

{
  "mcpServers": {
    "ira-researcher": {
      "command": "node",
      "args": ["C:\\path\\to\\IRA-RESEARCHER\\src\\index.js"],
      "env": {
        "IRA_HEADLESS": "false",
        "IRA_WINDOW": "maximize",
        "IRA_GHOST": "true"
      }
    }
  }
}

3. Use

The 40 tools appear automatically: ira_navigate, ira_click, ira_screenshot, etc.

🧰 Tools (40)

Category	Tools
Navigation	`ira_navigate`, `ira_go_back`, `ira_go_forward`, `ira_reload`
Interaction	`ira_click`, `ira_type`, `ira_hover`, `ira_drag`, `ira_upload`, `ira_select`, `ira_keyboard`
Vision & Reading	`ira_screenshot`, `ira_element_screenshot`, `ira_extract_images`, `ira_get_state`, `ira_read_page`, `ira_find`, `ira_extract_text`, `ira_extract_table`, `ira_get_html`
Tabs	`ira_tabs`, `ira_switch_tab`, `ira_close_tab`, `ira_new_tab`
Debug & DevTools	`ira_console`, `ira_network`, `ira_javascript`, `ira_inspect_element`, `ira_get_styles`, `ira_performance`, `ira_storage`, `ira_network_timing`, `ira_audit_accessibility`
Utility	`ira_wait`, `ira_scroll`, `ira_set_viewport`, `ira_cookies`, `ira_pdf`, `ira_intercept`
Health & Status	`ira_health`

⚙️ Environment Variables

Variable	Default	Description
`IRA_HEADLESS`	`false`	Run browser in headless mode
`IRA_WINDOW`	`auto`	Window sizing: `maximize`, `auto` (detect screen), or `WxH` like `1280x800`
`IRA_GHOST`	`true`	Enable ghost overlay UI
`IRA_STEALTH`	`true`	Enable anti-detection measures
`IRA_PROXY`	``	Proxy URL or comma-separated pool
`IRA_PROXY_ROTATE`	`false`	Auto-rotate proxies randomly
`IRA_DEBUG`	`false`	Enable verbose debug logging

Window visibility: Set IRA_HEADLESS=false + IRA_WINDOW=maximize to open a maximized, focused Chrome window on Windows. The browser auto-detects your screen work area and uses --start-maximized to bypass OS focus-steal blocks.

👻 Ghost Effects

When enabled, a floating panel appears on the right side of the browser showing all actions in real-time:

▶️ Action (green) — navigation, clicks
💭 Thought (orange) — reasoning
✅ Success (green) — completed actions
❌ Error (red) — failures
🟠 Click ripples — orange expanding circles at click points
🟢 Typing glow — green glow on active input fields
🔴 Drag arrows — animated SVG path from start to end
📸 Screenshot flash — brief white flash

Toggle panel: Ctrl+Shift+I

📁 Project Structure

IRA-RESEARCHER/
├── src/
│   ├── index.js              ← Entry point (uses pipeline)
│   ├── pipeline.js           ← Middleware: logging, timing, error wrapping
│   ├── browser.js            ← Browser launcher + CDP console/network tracking
│   ├── utils.js              ← Shared helpers (textResult, ghost effects)
│   ├── tools/                ← 40 tools (9 files)
│   │   ├── navigation.js     ← 4 tools
│   │   ├── interaction.js    ← 7 tools
│   │   ├── vision.js         ← 3 tools
│   │   ├── reading.js        ← 6 tools
│   │   ├── tabs.js           ← 4 tools
│   │   ├── debug.js          ← 3 tools
│   │   ├── devtools.js       ← 6 tools
│   │   ├── utility.js        ← 6 tools (wait, scroll, set_viewport, cookies, pdf, intercept)
│   │   └── status.js         ← 1 tool (ira_health)
│   └── ghost/index.js        ← Ghost effects
├── package.json
└── README.md

📊 Comparison

Feature	Claude-in-Chrome	Browser MCP	browser-use	IRA-RESEARCHER
Tools	18	12	14+20	40
Browser launch	Manual	Manual	Auto	Auto
Extension needed	Yes	Yes	No	No
Ghost effects	None	None	Panel	7 effects
Stealth mode	No	No	Cloud	puppeteer-extra
Proxy rotation	No	No	No	Auto
DevTools access	Console+Net	Console	None	9 tools
API keys needed	No	No	Yes	No
Setup steps	4	3	2	2

IRA-RESEARCHER