IRA-RESEARCHER
Allows GitHub Copilot to control a browser for web automation tasks such as navigation, clicking, form filling, and screenshots.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@IRA-RESEARCHERopen 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
MCP browser server for Claude, Cursor, Copilot, OpenCode, and any MCP-compatible AI tool. 40 tools, ghost panel, stealth mode, full DevTools access. No API keys needed.
Powered by Neural Nexus Tech
Tags: mcp server mcp browser browser automation puppeteer mcp claude browser cursor mcp ai agent browser mcp tools headless browser web scraping mcp devtools mcp ghost panel
✨ What is this?
IRA-RESEARCHER is an MCP (Model Context Protocol) server that gives AI assistants full control of a Chrome browser. It works with Claude Desktop, Claude Code, Cursor, VS Code Copilot, OpenCode, Windsurf, Aider, Cline, and any tool that supports MCP.
40 tools — navigate, click, type, screenshot, read pages, inspect elements, run JavaScript, intercept requests, and more
👻 Ghost panel — real-time overlay showing every action in the browser
🛡️ Stealth mode — anti-detection evasions to avoid bot blocks
🔧 Full DevTools — console, network, performance, storage, accessibility audit
🏃 Auto browser launch — opens Chrome automatically, no extension needed
🔑 Zero API keys — runs locally, no cloud dependency
Related MCP server: Ghost Browser MCP
📋 Quick Start (2 steps)
Option A: Run from npm (easiest)
npm install -g ira-researcherThen add to your MCP config:
{
"mcpServers": {
"ira-researcher": {
"command": "ira-researcher",
"env": {
"IRA_HEADLESS": "false",
"IRA_WINDOW": "maximize",
"IRA_GHOST": "true"
}
}
}
}Option B: Run from source
git clone https://github.com/neuralnexustech/IRA-RESEARCHER.git
cd IRA-RESEARCHER
npm install
npx puppeteer browsers install chromeThen add to your MCP config (replace path):
{
"mcpServers": {
"ira-researcher": {
"command": "node",
"args": ["C:\\path\\to\\IRA-RESEARCHER\\src\\index.js"],
"env": {
"IRA_HEADLESS": "false",
"IRA_WINDOW": "maximize",
"IRA_GHOST": "true"
}
}
}
}Add to Any MCP Client
.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=trueOr 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 43 tools appear automatically: ira_navigate, ira_click, ira_screenshot, etc.
🧰 Tools (43)
Category | Tools |
Navigation |
|
Interaction |
|
Vision & Reading |
|
Tabs |
|
Debug & DevTools |
|
Utility |
|
Instance Management |
|
Health & Status |
|
⚙️ Environment Variables
Variable | Default | Description |
|
| Run browser in headless mode |
|
| Window sizing: |
|
| Enable ghost overlay UI |
|
| Enable anti-detection measures |
| `` | Proxy URL or comma-separated pool |
|
| Auto-rotate proxies randomly |
|
| Enable verbose debug logging |
Window visibility: Set
IRA_HEADLESS=false+IRA_WINDOW=maximizeto open a maximized, focused Chrome window on Windows. The browser auto-detects your screen work area and uses--start-maximizedto 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 (43 tools, auto-recovery)
│ ├── pipeline.js ← Middleware: logging, timing, error wrapping
│ ├── browser.js ← Single Chrome instance + reuse + registry
│ ├── utils.js ← Shared helpers (textResult, ghost effects)
│ ├── tools/ ← 43 tools (10 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 ← 7 tools (wait, scroll, set_viewport, cookies, pdf, intercept, shutdown)
│ │ ├── selectors.js ← Shared element selectors
│ │ └── status.js ← 1 tool (ira_health)
│ └── ghost/index.js ← Ghost effects
├── package.json
└── README.mdThis server cannot be installed
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Latest Blog Posts
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/neuralnexustech/IRA-RESEARCHER'
If you have feedback or need assistance with the MCP directory API, please join our Discord server