aether-mcp-server 2.0.0 → 2.0.2
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 +104 -0
- package/package.json +3 -2
package/README.md
ADDED
|
@@ -0,0 +1,104 @@
|
|
|
1
|
+
# Aether — AI Browser Controller
|
|
2
|
+
|
|
3
|
+
Give your AI agent a real browser. Aether is an MCP server that lets Claude, Cursor, Kilo Code, Codex, and other AI coding agents inspect and control a live browser through the Chrome DevTools Protocol — no extension needed.
|
|
4
|
+
|
|
5
|
+
## Install
|
|
6
|
+
|
|
7
|
+
```bash
|
|
8
|
+
npx -y aether-mcp-server
|
|
9
|
+
```
|
|
10
|
+
|
|
11
|
+
Or globally:
|
|
12
|
+
|
|
13
|
+
```bash
|
|
14
|
+
npm install -g aether-mcp-server
|
|
15
|
+
```
|
|
16
|
+
|
|
17
|
+
## MCP Client Config
|
|
18
|
+
|
|
19
|
+
```json
|
|
20
|
+
{
|
|
21
|
+
"mcpServers": {
|
|
22
|
+
"aether": {
|
|
23
|
+
"command": "npx",
|
|
24
|
+
"args": ["-y", "aether-mcp-server"]
|
|
25
|
+
}
|
|
26
|
+
}
|
|
27
|
+
}
|
|
28
|
+
```
|
|
29
|
+
|
|
30
|
+
If installed globally:
|
|
31
|
+
|
|
32
|
+
```json
|
|
33
|
+
{
|
|
34
|
+
"mcpServers": {
|
|
35
|
+
"aether": {
|
|
36
|
+
"command": "aether-mcp-server",
|
|
37
|
+
"args": []
|
|
38
|
+
}
|
|
39
|
+
}
|
|
40
|
+
}
|
|
41
|
+
```
|
|
42
|
+
|
|
43
|
+
No cloning. No building. No absolute paths.
|
|
44
|
+
|
|
45
|
+
## What It Does
|
|
46
|
+
|
|
47
|
+
- Launches or connects to Chrome, Edge, Brave, or Firefox with remote debugging
|
|
48
|
+
- Click by text, role, label, or placeholder — not fragile CSS selectors
|
|
49
|
+
- Native CDP keyboard and mouse events, not DOM simulation
|
|
50
|
+
- Smart page snapshots that auto-invalidate on DOM changes
|
|
51
|
+
- Set-of-Marks visual element references for screenshot-based workflows
|
|
52
|
+
- Shadow DOM and same-origin iframe support built in
|
|
53
|
+
|
|
54
|
+
## Browser Setup
|
|
55
|
+
|
|
56
|
+
```
|
|
57
|
+
launch_browser()
|
|
58
|
+
launch_browser(browser="chrome")
|
|
59
|
+
launch_browser(browser="edge")
|
|
60
|
+
launch_browser(browser="brave")
|
|
61
|
+
```
|
|
62
|
+
|
|
63
|
+
Connect to an existing browser:
|
|
64
|
+
|
|
65
|
+
```bash
|
|
66
|
+
chrome --remote-debugging-port=9222
|
|
67
|
+
```
|
|
68
|
+
|
|
69
|
+
```
|
|
70
|
+
connect_browser(mode="connect", port=9222)
|
|
71
|
+
```
|
|
72
|
+
|
|
73
|
+
## Key Tools
|
|
74
|
+
|
|
75
|
+
| Tool | What it does |
|
|
76
|
+
|---|---|
|
|
77
|
+
| `browser_status` | Connection and active tab status |
|
|
78
|
+
| `snapshot_compact` | Fast title, URL, and interactive element list |
|
|
79
|
+
| `list_interactive_elements` | Element refs for click/fill flows |
|
|
80
|
+
| `click_text`, `click_role`, `fill_label` | Semantic actions |
|
|
81
|
+
| `click_by_ref`, `fill_by_selector` | Direct element targeting |
|
|
82
|
+
| `get_state` | Screenshot, tabs, DOM snapshot |
|
|
83
|
+
| `get_logs`, `get_network_errors` | Live debugging output |
|
|
84
|
+
| `act` | Broad compatibility action tool |
|
|
85
|
+
|
|
86
|
+
## Project-Local Learning
|
|
87
|
+
|
|
88
|
+
Aether stores learned lessons and reusable skills inside your project under `.aether/` — lightweight automation notes that make future runs faster. Call `configure_aether_memory` with your project root to enable it.
|
|
89
|
+
|
|
90
|
+
## Environment Variables
|
|
91
|
+
|
|
92
|
+
| Variable | Purpose |
|
|
93
|
+
|---|---|
|
|
94
|
+
| `AETHER_MODE` | `"cdp"` (default) or `"extension"` |
|
|
95
|
+
| `AETHER_PROJECT_ROOT` | Fallback project root for aether memory |
|
|
96
|
+
|
|
97
|
+
## Requirements
|
|
98
|
+
|
|
99
|
+
- Node.js >= 18
|
|
100
|
+
- Chrome, Edge, Brave, or Firefox
|
|
101
|
+
|
|
102
|
+
## License
|
|
103
|
+
|
|
104
|
+
ISC
|
package/package.json
CHANGED
|
@@ -1,13 +1,14 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "aether-mcp-server",
|
|
3
|
-
"version": "2.0.
|
|
3
|
+
"version": "2.0.2",
|
|
4
4
|
"description": "Aether MCP Server - AI Browser Controller",
|
|
5
5
|
"main": "dist/index.js",
|
|
6
6
|
"bin": {
|
|
7
7
|
"aether-mcp-server": "dist/index.js"
|
|
8
8
|
},
|
|
9
9
|
"files": [
|
|
10
|
-
"dist/"
|
|
10
|
+
"dist/",
|
|
11
|
+
"README.md"
|
|
11
12
|
],
|
|
12
13
|
"scripts": {
|
|
13
14
|
"build": "tsc",
|