safari-devtools-mcp 0.2.0 → 1.1.0
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 +17 -3
- package/package.json +14 -3
package/README.md
CHANGED
|
@@ -1,6 +1,9 @@
|
|
|
1
1
|
# Safari DevTools MCP
|
|
2
2
|
|
|
3
|
-
[](https://npmjs.org/package/safari-devtools-mcp)
|
|
3
|
+
[](https://npmjs.org/package/safari-devtools-mcp)
|
|
4
|
+
[](https://npmjs.org/package/safari-devtools-mcp)
|
|
5
|
+
[](https://github.com/HayoDev/safari-devtools-mcp/blob/main/LICENSE)
|
|
6
|
+
[](https://npmjs.org/package/safari-devtools-mcp)
|
|
4
7
|
|
|
5
8
|
`safari-devtools-mcp` lets your coding agent (such as Claude, Cursor, Copilot or Gemini) control and inspect a live Safari browser on macOS. It acts as a Model-Context-Protocol (MCP) server, giving your AI coding assistant access to Safari DevTools for debugging, automation, and testing.
|
|
6
9
|
|
|
@@ -10,11 +13,22 @@ Chrome developers get powerful AI debugging through [chrome-devtools-mcp](https:
|
|
|
10
13
|
|
|
11
14
|
> **Note:** This server exposes browser content (page data, console logs, network traffic) to MCP clients. Avoid browsing sensitive websites or entering credentials while a session is active.
|
|
12
15
|
|
|
16
|
+
## Why safari-devtools-mcp?
|
|
17
|
+
|
|
18
|
+
Unlike AppleScript-only solutions, this project uses **WebDriver** for capabilities that scripting alone cannot provide:
|
|
19
|
+
|
|
20
|
+
- **Network request/response body capture** — intercepts fetch and XHR calls with full headers, payloads, and timing
|
|
21
|
+
- **DOM snapshots via accessibility tree** — stable element UIDs that survive page re-renders, not brittle CSS selectors
|
|
22
|
+
- **CSS computed style inspection** — read any computed property from any element
|
|
23
|
+
- **Cookie and storage management** — read, write, and delete cookies, localStorage, and sessionStorage
|
|
24
|
+
- **Element-level screenshots** — capture individual elements, not just the full viewport
|
|
25
|
+
- **Session auto-recovery** — detects dead SafariDriver sessions and reconnects transparently
|
|
26
|
+
|
|
13
27
|
## Key features
|
|
14
28
|
|
|
15
29
|
- **Browser debugging**: Capture console logs, inspect network requests, and evaluate JavaScript — with stack traces and full request/response details.
|
|
16
30
|
- **Reliable automation**: Click, type, fill forms, drag and drop, and press keyboard shortcuts using accessibility-tree snapshots with stable UIDs.
|
|
17
|
-
- **Native macOS integration**: Tab management via AppleScript for listing, switching, and controlling Safari tabs across windows
|
|
31
|
+
- **Native macOS integration**: Tab management via AppleScript for listing, switching, and controlling Safari tabs across windows
|
|
18
32
|
|
|
19
33
|
## Requirements
|
|
20
34
|
|
|
@@ -118,7 +132,7 @@ Add the standard config to your `.junie/mcp.json` in the project root.
|
|
|
118
132
|
Open "Install MCP Server" in Raycast and fill in:
|
|
119
133
|
|
|
120
134
|
- **Command**: `npx`
|
|
121
|
-
- **Arguments**: `-y safari-devtools-mcp`
|
|
135
|
+
- **Arguments**: `-y safari-devtools-mcp@latest`
|
|
122
136
|
|
|
123
137
|
Or copy the standard config JSON above before opening the command — Raycast will auto-fill the form.
|
|
124
138
|
|
package/package.json
CHANGED
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "safari-devtools-mcp",
|
|
3
3
|
"mcpName": "io.github.HayoDev/safari-devtools-mcp",
|
|
4
|
-
"version": "
|
|
5
|
-
"description": "
|
|
4
|
+
"version": "1.1.0",
|
|
5
|
+
"description": "Safari DevTools MCP — real browser debugging with network interception, DOM inspection, cookie/storage management, and CSS analysis for AI agents on macOS",
|
|
6
6
|
"type": "module",
|
|
7
7
|
"main": "build/src/index.js",
|
|
8
8
|
"bin": {
|
|
@@ -37,12 +37,23 @@
|
|
|
37
37
|
"homepage": "https://github.com/HayoDev/safari-devtools-mcp#readme",
|
|
38
38
|
"keywords": [
|
|
39
39
|
"mcp",
|
|
40
|
+
"mcp-server",
|
|
40
41
|
"safari",
|
|
42
|
+
"safari-devtools",
|
|
41
43
|
"devtools",
|
|
42
44
|
"debugging",
|
|
43
45
|
"browser-automation",
|
|
44
46
|
"model-context-protocol",
|
|
45
|
-
"ai-
|
|
47
|
+
"ai-agents",
|
|
48
|
+
"ai-coding",
|
|
49
|
+
"macos",
|
|
50
|
+
"webkit",
|
|
51
|
+
"webdriver",
|
|
52
|
+
"network-interception",
|
|
53
|
+
"dom-inspection",
|
|
54
|
+
"claude",
|
|
55
|
+
"cursor",
|
|
56
|
+
"copilot"
|
|
46
57
|
],
|
|
47
58
|
"engines": {
|
|
48
59
|
"node": ">=18.0.0"
|