ira-researcher 1.0.3 → 1.0.4
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +58 -13
- package/package.json +20 -5
package/README.md
CHANGED
|
@@ -1,31 +1,76 @@
|
|
|
1
1
|
# 🔬 IRA-RESEARCHER — Browser Automation MCP Server
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
> **MCP browser server** for Claude, Cursor, Copilot, OpenCode, and any MCP-compatible AI tool.
|
|
4
|
+
> **40 tools**, ghost panel, stealth mode, full DevTools access. No API keys needed.
|
|
4
5
|
|
|
5
6
|
> **Powered by [Neural Nexus Tech](https://neuralnexustech.com/)**
|
|
6
7
|
|
|
7
|
-
|
|
8
|
+
**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`
|
|
8
9
|
|
|
9
|
-
|
|
10
|
-
- **👻 Ghost effects** — floating action panel, click ripples, typing glow, drag arrows, scroll indicators, screenshot flash
|
|
11
|
-
- **🛡️ Stealth mode** — puppeteer-extra anti-detection
|
|
12
|
-
- **🌐 Auto proxy rotation** — random proxy from a pool
|
|
13
|
-
- **🔧 Full DevTools** — console, network, elements, styles, performance, storage, accessibility audit
|
|
14
|
-
- **🏃 Auto browser launch** — no Chrome extension needed
|
|
15
|
-
- **🔑 Zero API keys** — no LLM dependency
|
|
10
|
+
## ✨ What is this?
|
|
16
11
|
|
|
17
|
-
|
|
12
|
+
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.
|
|
13
|
+
|
|
14
|
+
- **40 tools** — navigate, click, type, screenshot, read pages, inspect elements, run JavaScript, intercept requests, and more
|
|
15
|
+
- **👻 Ghost panel** — real-time overlay showing every action in the browser
|
|
16
|
+
- **🛡️ Stealth mode** — anti-detection evasions to avoid bot blocks
|
|
17
|
+
- **🔧 Full DevTools** — console, network, performance, storage, accessibility audit
|
|
18
|
+
- **🏃 Auto browser launch** — opens Chrome automatically, no extension needed
|
|
19
|
+
- **🔑 Zero API keys** — runs locally, no cloud dependency
|
|
20
|
+
|
|
21
|
+
## 📋 Quick Start (2 steps)
|
|
22
|
+
|
|
23
|
+
### Option A: Run from npm (easiest)
|
|
24
|
+
|
|
25
|
+
```powershell
|
|
26
|
+
npm install -g ira-researcher
|
|
27
|
+
```
|
|
28
|
+
|
|
29
|
+
Then add to your MCP config:
|
|
30
|
+
|
|
31
|
+
```json
|
|
32
|
+
{
|
|
33
|
+
"mcpServers": {
|
|
34
|
+
"ira-researcher": {
|
|
35
|
+
"command": "ira-researcher",
|
|
36
|
+
"env": {
|
|
37
|
+
"IRA_HEADLESS": "false",
|
|
38
|
+
"IRA_WINDOW": "maximize",
|
|
39
|
+
"IRA_GHOST": "true"
|
|
40
|
+
}
|
|
41
|
+
}
|
|
42
|
+
}
|
|
43
|
+
}
|
|
44
|
+
```
|
|
45
|
+
|
|
46
|
+
### Option B: Run from source
|
|
18
47
|
|
|
19
|
-
### 1. Install
|
|
20
48
|
```powershell
|
|
49
|
+
git clone https://github.com/neuralnexustech/IRA-RESEARCHER.git
|
|
21
50
|
cd IRA-RESEARCHER
|
|
22
51
|
npm install
|
|
23
52
|
npx puppeteer browsers install chrome
|
|
24
53
|
```
|
|
25
54
|
|
|
26
|
-
|
|
55
|
+
Then add to your MCP config (replace path):
|
|
56
|
+
|
|
57
|
+
```json
|
|
58
|
+
{
|
|
59
|
+
"mcpServers": {
|
|
60
|
+
"ira-researcher": {
|
|
61
|
+
"command": "node",
|
|
62
|
+
"args": ["C:\\path\\to\\IRA-RESEARCHER\\src\\index.js"],
|
|
63
|
+
"env": {
|
|
64
|
+
"IRA_HEADLESS": "false",
|
|
65
|
+
"IRA_WINDOW": "maximize",
|
|
66
|
+
"IRA_GHOST": "true"
|
|
67
|
+
}
|
|
68
|
+
}
|
|
69
|
+
}
|
|
70
|
+
}
|
|
71
|
+
```
|
|
27
72
|
|
|
28
|
-
|
|
73
|
+
### Add to Any MCP Client
|
|
29
74
|
|
|
30
75
|
<details>
|
|
31
76
|
<summary><b>Cursor</b></summary>
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "ira-researcher",
|
|
3
|
-
"version": "1.0.
|
|
3
|
+
"version": "1.0.4",
|
|
4
4
|
"description": "The most powerful browser automation MCP server — 40 tools, ghost effects, stealth mode, DevTools access. Powered by Neural Nexus Tech (https://neuralnexustech.com/)",
|
|
5
5
|
"main": "src/index.js",
|
|
6
6
|
"type": "module",
|
|
@@ -18,19 +18,34 @@
|
|
|
18
18
|
},
|
|
19
19
|
"keywords": [
|
|
20
20
|
"mcp",
|
|
21
|
-
"
|
|
22
|
-
"
|
|
21
|
+
"mcp-server",
|
|
22
|
+
"mcp-browser",
|
|
23
|
+
"browser-automation",
|
|
23
24
|
"puppeteer",
|
|
24
|
-
"
|
|
25
|
+
"puppeteer-mcp",
|
|
26
|
+
"ghost-panel",
|
|
25
27
|
"devtools",
|
|
26
28
|
"stealth",
|
|
27
29
|
"claude",
|
|
30
|
+
"claude-desktop",
|
|
31
|
+
"claude-code",
|
|
28
32
|
"cursor",
|
|
33
|
+
"cursor-mcp",
|
|
34
|
+
"copilot",
|
|
35
|
+
"vscode-mcp",
|
|
36
|
+
"windsurf",
|
|
37
|
+
"aider",
|
|
38
|
+
"cline",
|
|
39
|
+
"opencode",
|
|
29
40
|
"ai-agent",
|
|
30
41
|
"web-scraping",
|
|
31
42
|
"headless",
|
|
32
43
|
"chrome",
|
|
33
|
-
"
|
|
44
|
+
"browser-use",
|
|
45
|
+
"mcp-tools",
|
|
46
|
+
"web-automation",
|
|
47
|
+
"screenshot",
|
|
48
|
+
"web-testing"
|
|
34
49
|
],
|
|
35
50
|
"author": "bidre",
|
|
36
51
|
"license": "GPL-3.0-or-later",
|